RESOURCE ALLOCATION DECISION FUNCTION FOR 
RESOURCE MANAGEMENT ARCHITECTURE 
AND CORRESPONDING PROGRAMS THEREFOR 

STATEMENT OF GOVERNMENT INTEREST 
The invention described herein was made in the performance of official dunes by 
employees of the Department of the Navy or by research en under contract to an agency of 
the United States government and, thus, the invention disclosed herein may be manufactured, 
used, licensed by or for the Government for governmental purposes without the payment of 
any royalties thereon. 

BACKGROUND OF THE INVENTION 

The present invention relates generally to resource management systems by which 
networked computers cooperate in performing at least one task too complex for a single 
computer to perform. More specifically, the present invention relates to a resource 
management system which dynamically and remotely controls networked computers to 
thereby permit them to cooperate in performing tasks that are too complex for any single 
computer to perform. Advantageously, software programs for converting a general purpose 
computer network into a resource managed network are also disclosed. 

The instant application claims priority from Provisional Patent Application Serial No. 
60/207,891, which was filed on May 2f, 2000. The Provisional Patent Application is 
incorporated herein in its entirety by reference. 



Resource Management consists of a set of a 



s that 



provides an ability to dynamically allocate computing tasks to a collection of networked 
computing resources (computer processors interconnected on a network) based on the 
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Several commercial companies are dev eloping and implementing similar capabilities. 
Moreover, several companies, most notably IBM. have developed networks where each 
netw orked desktop computer becomes a parallel processor in a distributed computer system 
when the desktop computer is otherwise idle. 

It will be appreciated that these approaches to computing in a distributed environment 
do not provide a system that is both flexible and adaptive (or at least easily adapted) to 
changes in system configuration, performance bottlenecks, survivability requirements, 
scalability, etc. 

What is needed is a Resource Management Architecture which permits flexible 
control, i.e., allowing autonomous start up and shut down of application copies on host 
machines to accommodate changes in data processing requirements. What is also needed is 
functionality included in the Resource Management Architecture which permits the Resource 
Management Architecture to determine the near-optimal alignment of host and application 
resources in the distributed environment It would be desirable to have a user- friendly 
technique with which to specify quality of service (QoS) requirements for each host, each 
application, and the network in which the hosts are connected. What is also needed is 
lsure that the specified QoS goals are being met. 



SUMMARY OF THE INVENTION 
Based on the above and foregoing, it can be appreciated that there presently exists a 
need in the art for a Resource Management Architecture, which overcomes the above- 
described deficiencies. The present invention was motivated by a desire to overcome the 
drawbacks and shortcomings of the presently available technology, and thereby fulfill this 
need in the an. 

According to one aspect, the present invention provides, in a distributed em ironment 



following measures: 

an application developer/user description of application computer program 

performance requirements; 

measured perfo rmance of each application programs ; 

measured workload (CPU processing load, memory accesses, disk accesses) of each 
computer in the network; and 
• measured inter-computer message communication traffic on the network. 



Many attempts to form distributed systems and environments have been made in the 
past. For example, several companies and organizations have networked multiple computers 
to form a massively parallel supercomputer of sorts One the best known of these efforts is 
SETl@home, which is organized by SET! (Search for Extraterrestrial Intelligence), a 
scientific effort aiming to determine if there is intelligent life out in the universe. 

Typically, the search means the search of billions of radio freq uencies that flood the 
universe in the hopes of finding another civilization thai might be transmitting a radio signal. 
Most of the SET! programs in existence today, including those at UC Berkeley, build large 
computers that analyze that data from the telescope in real time. None of these computers 
look very deeply at the data for weak signals nor do they look for a large class of signal types. 
The reason for this is because they are limited by the amount of computer power available 
for data analysis. To extract the weakest signals, a great amount of computer power is 
necessary. It would take a monstrous supercomputer to get the job done. Moreover, SETI 
programs could never afford to build or buy that computing power. Thus, rather than use a 
huge computer to do the job, the SETI learn developed software to use thousands of small 
computers, all working simultaneously on different parts of the analysis, to run the search 
routine. This is accomplished with a screen saver that can retrieve a data block over the 
internet, analyze that data, and then report the results back to SETI. 



comprised of hosts instantiating copies of a scalable application, a resource management 
dev ice generating signals which start up, shutdown or move a selected one of the copies 
responsive to first inforrnation regarding performance of all copies of the scalable application 
and second information regarding performance of the hosts. 

BRIEF DESCRIPTION OF THE DRAWINGS 

These and various other features and aspects of the present invention will be readiry 
understood with reference to the following detailed description taken in conjunction with the 
accompanying drawings, inwhichlikeorsimilar numbers are used throughout, and in whi eh: 

FigFIGS. 1-isA. t B collectively represent a high-level block diagram ofhardwareand 
software components implemented in the Resource Management System according to the 
present invention; 

FtgFlGS. 2isA. 2B collects clj represent afunctional block diagram of the Resource 
Management Architecture according to the present invention; 

FtglG. 3 is a functional block diagram illustrating functional elements included in the 
system specification library (SSL) implementation of the Resource Management System 
according to the present invention; 

FtglG. 4 is a block diagram illustrating one technique for implementing the Resource 
(Application) Control functional group FG5 in FtgFIGS. 22A. 28 using discrete software 
components; 

FrgFIGS. 5-rsA. ?B represent a screen capture of a program control display FG54 
generated by the software components illustrated in FiglO. 4; 

FrgRGS. 6-bA. <>B represent a screen capture of a host display generated by the 
Resource Management Architecture according to the present invention; 

FrgF iGS. 7isA, 7 B represent a screen capture of performance data regarding several 
of the hosts A - N included in FtgFtGS. 66 A, <>B; 

FrgFIGS. 8-isA. 8B represent a screen capture of a path display generated by the 
Resource Management Architecture according to the present invention; 
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FtgFIGS. 9-bA, '>8 represent a screen capture of the Resource Management Decision 
Review Display, which provides a summary of allocation and reallocation actions taken by 
the Resource Manager; 

FijsFlGS. +6 1 OA, 108 and U-weA. 1 IB represent screen captures illustrating 
s alternative, user-configurable displays generated from received data via standardized 

message formats and open interfaces; 

FrgFtGS. 12-tsA. 12B represent a screen capture of an exemplary version of the 
Readiness Display FG66 according to the present invention; 

Figs. 1 3A, 1 3B, and 1 3C are block diagrams which are useful in explaining various 
10 operational and functional aspects of the Resource Management Architecture according to 

the present invention: and 

FrglG. 14 is a high-level block diagram illustrating connectivity and data flow 
between the Hardware Broker and the other Resource Management and Resource 
Management-related functional elements in the Resource Management Architecture, and 
I j FisIG. 15 is ahigh-tevel block diagram of a CPU-based general computer which can 

act as a host in the Resource Management Architecture according to the present invention. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

20 The Resource Management Architecture, which was and is being developed by the 

Naval Surface Warfare Center - Dahlgren Division (NSWC-DD), provides capabilities for 
monitoring hosts, networks, and applications within a distributed computing environment. 
Moreover, the Resource Management Architecture provides the capability of dynamically 
allocating, and reallocating, applications to hosts as needed in order to maintain user- 

15 specified system performance goals Advantageously, the Resource Management architecture 

provides functionality for determining both how each component within the distributed 
environment is performing and what options are available for attempting to correct deficient 
performance, determining the proper actions that should be taken, and enacting the 
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determined course of action. In addition to these capabilities, the architecture also allows for 
operator control over creating and loading pre-defined static, dynamic, or combined static 
and dynamic system and/or host configurations. One particularly desirable feature of the 
Resource Management Architecture is that it provides capabilities for monitoring system 
S performance along with the ability to dynamically allocate and reallocate system resources 

as required. 

Before addressing the various features and aspects of the present invention, it would 
be useful to establish both terminology and the conventions that the instant application will 

to follow throughout. In terms of terminology, a glossary section is presented below. In terms 

of conventions, this application includes information such as source code listing in an 
Appendix section. Since the source code itself is hundreds of pages, the aAppendix section 
is divided into attached pages, e.g.. Attached Appendix A, and an optical disk section, e g., 
CD-Appendix N. Thus, while the appendices are listed in order, the reader must look to the 

15 signaling language to determine whether any particular appendix is actually provided in 

printed form. 



API 


API (application programming interface) A set of subroutines or 




functions that a program, or application, can call to invoke sonme 




functionality contained in another software or hardware component. 




The Windows API consists of more than 1 .000 functions that 




programs written in C, C++, Pascal, and other languages can call to 




create windows, open files, and perform other essential tasks. An 




application that wants to display an on-screen message can call 




Windows' MessageBox API function, for example. 



Ncwoon 



BNF 


Acronym for ' Backus Normal Form' (-often- incorrectly expanded as 
1 Backus -Naur Form'), a metasyntactic notation -used to specify the 
syntax of programming languages-, command sets, and the like. 
Wider)' used for language descriptions but seldom documented 
anywhere - , so that it must usually be learned by osmosis - from other 
hackers. 


DAEMON 


A background process on a host or Web server {-normally in a UNIX 
environment ), waiting to perform tasks. Well-known examples of 
daemons are sendmail and HTTP daemon. 


FUNCTION 


A capability available on a host due to the presence of software (e.g., a 
program), a software module (e.g., an API), etc. 


GLOBUS 


Wide area network (WAN) enterprise management and control 
capability developed under DARPA sponsorship by USC/IS1. 


HOST 


A device including a central processor controlled by an operating 


[CMP 


Internet Control Message Protocol - ICMP is an extension to the 
Internet Protocol. It allows for the generation of error messages, test 
packets and informational messages related to IP. It is defined in STD 
5. RFC 792. 


JEWEL 


An open-source instrumentation package produced by the German 
National Research Center for Computer Science 


NFS 


Network File System - A protocol developed by Sun Microsystems, 
and defined in RFC 1 094-, which allows a computer system to access 
files over a network as if they were on its local disks. This protocol 
has been incorporated in products by more than two hundred 
companies, and is now tide facto Internet standard. 


QoS 


Quality of Service 
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REMOS 


Remos (REsource MOnitoring System)is a network bandwidth and 
topology monitoring system developed under DARPA sponsorship -by 
CMU. Remos allows network-aware applications to obtain relevant 
information about their execution environment. The major challenges 
in defining a uniform interface are network heterogeneity, diversity in 
traffic requirements, variability of the information, and resource 
sharing in the network. Remos provides an API that addresses these 
issue by striking a compromise between accuracy (the information 
provided is best-effort, but includes statistical information if 
available) and efficiency (providing a query-based interface, so 
applications incur overhead only when they acquire information). 
Remos supports two classes of queries. "Flow queries" provide a 
portable way to describe a communication step to the Remos 
implementation, which uses its platform-dependent knowledge to 
return to the user the capacity of the network to meet this request. 
Topology queries" reverse the process, with the Remos 
implementation providing a portable description of the netw ork's 
behavior to the application. 


SNMP 


Simple Network Management Protocol Internet standard protocol 
defined in STD 15, RFC 1 157; developed to manage nodes, e g., hubs 
and switches, on an IP network. 



An exemplary system for implementing the Resource Management Architecture 
j according to the present invention is illustrate in FigflGS. +IA, IB, wtiich includes a 

plurality of Host computers A, B N operative!)' connected to one another and Resource 

Management hardware RM via a Network lOo. It will be appreciated that the hardware 
configuration illustrated in FIGS, la, IB constitutes a so-cailed grid system. Ii will also be 
appreciated that the network 100 advantageously can be any known network, e.g., a local 
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area network (LAN) or a wide area network (WAN). It will also be appreciated that the 




provide integration details. Moreover, it will be appreciated that the functions and 




hardware RM need not be a discrete piece of equipment; the hardware RM advantageously 




functionality of the Resource Management Architecture according to the present invention 




can be distributed across multiple platforms, e.g , the host eomputerts). as discussed in detail 




are interconnected to one another via middleware, which provides message passing interfaces 




below- In addressing the functional elements and applications in the distributed 




between substantially all of the Resource Management functions. This middleware package. 


J 


environment, it will be appreciated that hosts A-N each can instantiate applications 1-M. 


s 


RMComms, is fully described below. 




Thus, when all applications are being addressed, these applications will be denoted as Al - 








NM. 












an exemplary embodiment of the present invention are illustrated in PtgFlGS, 52 A, 2B. A 




Still referring to FrgFlGS. +IA, IB, each of the hosts A, B, etc., preferably is 




summary of the functions provided by the Resource Management Architecture is av ailable 


10 


controlled by an operating sj'Stem (OS A, OSB, etc. ), which permits Host A, for example, to 


10 


in Attached Appendix A. These functions, taken together, provide an integrated capability 




execute applications A 1 - AN, as well as an instrumentation daemon IDA, a Program Control 




for monitoring and control of a distributed computing environment. In addition, many of the 




(PC) agent PC A, and a Host Monitor HM A. U should be noted that instrumentation daemon 




functions (and functional groups) within the Resource Management Architecture can also be 




IDA, PC agent PC A, and Host Monitor HMA are integral to the Resource Management 




run in a non-integrated configuration, thus providing subsets of the integrated Resource 




Architecture while the operating system OSA and applications AI • AN are well known to 




Management capabilities. 


15 


one of ordinary skill in the art. 


IJ 










These functionfal) groups illustrated in FigFIGS. 22A, 2B include; 




In FrgFIGS. -HA. IB, the Resource Management Architecture RM advantageously 








includes an instrument collector 1 0 receiving data from all of the instrumentation daemons 




FG1 - Host and Network Monitoring. This function group consists of software which 




(IDA - ID'S) and providing data to instrument correlators) 20, which, in turn, provide 




monitors the host and network resources uithin the distributed environment The 


20 


correlation data to corresponding quality of service (QoS) managers 30. Resource 


10 


function group collects extensive run-time information on host and network 




Management Architecture RM also receives data from host monitors HMA- HMN at history 




configuration, statuses, and performance. Run-tune capabilities for discovering new 




servers 40, which maintain status and performance histories on each of the hosts A-N and 




hosts that have been started and for determining that existing hosts have gone down 




provide selected information to host load analyzer 50. Analyzer 50 advantageously 




are also provided. Distribution of current and historical status and performance data 




determines the host and network loads for both hosts A-N and their connecting network 1 00 




to other components of the Resource Management Architecture is also provided. A 


2J 


and provides that information to Resource Manager 60, which is the primary decision making 


2S 


more detailed discussion is provided bdow. 




component of the Resource Management Architecture. It will be appreciated that Resource 








Manager 60 also receives information from the QoS managers 30 and exchanges information 




FG2 - Application-Level Instrumentation. The instrumentation function group provides 




with program controller 70. Program controller 70 sends startup and shutdown orders to the 
-9- 
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Program Control Agents based on operator or Resource Manager-initiated orders. It will be 




Capabilities are provided for collecting and correlating application-provided data 




appreciated that the operator-initiated orders are received via the one of the program control 




such as appli cation statuses, states, performance, and internally detected errors Low- 




displays SO. 




overhead (API) libraries are provided for applications to use in sending out key 








internal event and performance data. This application data is forwarded to other 


S 


As will be discussed in greater detail below, the Resource Manager 60 is the primary 


5 


components of the instrumentation subsystem which collect data from applications 




decision-making component of the Resource Management Architecture. The Resource 




on hosts throughout the distributed environment The system also provides grammar- 




Manager 60 is responsible for determining: 




driven capabilities for correlating, combining, and reformatting application data into 




• how to respond to host and application failures; 




higher-level metrics (composite events) for use by displays or other Resource 




• where (i.e., which of hosts A -N) to place new applications; 




Management components. 


10 


• whichapplicationsto start up in response to the detection of a new host (host 


10 






N+l); 




FG3 - System Specifications. A specification language has been developed wnich allows 




• how to resolve application dependencies; 




the user to specify: 




• what applications should be started, stopped, or moved in response to 




1) application software system structure, capabilities, dependencies, and 




application system priority changes; and 




requirements; and 


1$ 


• based on recommendations from the QoS Managers, when and where 


IS 


2) hardware system (computer and network) structure, capabilities, and 




scalable application should be started or stopped. 




configuration. 








Specification files, based on this specification language, are created by the user and 




Before leaving FigFIGS. tIA, IB, is should be noted thai the functions, e.g., 




provide the model of the software and hardware components of the distributed 




instantiated programs or software program modules, in the Resource Management 




computing environment which is used by other Resource Management functions. The 


20 


Architecture advantageously can be distri buted across multiple platforms, e.g., multiple hosts 


20 


specification information is accessed by other Resource Management functions by- 




(which may or may not be the illustrated Hosts A -N) or a grid system. 




linking in a specification parser library and making library calls to read in the files 








and convert them to an internal object model. Specific specification data items can 




The major functional groups of the Resource Management Architecture according to 




then be retrieved via an object-oriented API. See the discussion below. 




the present invention are illustrated in FigFIGS. 22 A 213, The functions illustrated as solid 








boxes are components of the Resource Management Architecture and are fully described 


25 


FG-4 - Resource Allocation Decision-Making. This subsystem provides the reasoning and 




bdow, the functions denoted by diagonal striping denote third -party software which has been 




decision-making capabilities of the Resource Management architecture. The 








components of this subsystem use information from other subsystems in order to 




functionality. Thus, the latter functions will be described only to the extent necessary to 




determine the health and state of the distributed environment and the options that are 
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available for attempting to recover from faults or unacceptable performance. The 
functions in this particular functional group make decisions regarding; 

1) where new applications should be started; 

2) whether and where failed applications should be restarted; 

3) based on application inter-dependencies, whether and where additional 
applications should to be started prior to starting a particular application; 

4) whether applications are meeting performance requirements and whether 
and where an application can be scaled up or moved to- when it is necessary 
to improve performance; 

5) whether scalable applications are performing well within performance 
requirements and can be scaled down and which copy should be brought 
down; and 

6) based on operator changes to application system priorities, whether and 
where new applications need to be started or whether and which existing 
applications need to be shut down, 

FG5 - Application (Resource) Control. This subsystem provides application control (i.e., 
Program Control) capabilities which permit starting, stopping, and configuring 
applications on each of the hosts in the distributed environment. The subsystem 
provides both interactive operator control of the distributed environment as well as 
automatic control via configuration orders received from the Resource Allocation 
Decision-Making Subsystem (i.e., the Resource Manager component). The 
interactive controls allow an operator to create, load, save, and edit pre-defined 
system configurations (e.g., lists of applications that are to be run, with or without 
specific host mappings), determine the status and configuration of currently running 
programs, and start and stop any or all applications. Both static (operator-entered) 
mappings of applications to hosts and dynamic mappings of applications to hosts 
(where the Resource Allocation Decision-Making Subsystem will be queried to 
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discussion below also includes an overview of the information flow between function blocks 
within the same functional group and between function blocks in separate functional groups. 

FGI - Host xnd Network Monitoring Functional Group 

Functional group FGI provides extensive monitoring capabilities at the host and 
network levels. The information monitored includes statuses, configuration information, 
performance metrics, and detected fault conditions. By monitoring the individual hosts and 
network components within the distributed environment, the functional group FGI 
determines: 

• Accurate State and Performance Information, primarily by gathering the level 
of information necessary for accurately determining the state and health of 
each machine and network component. 

• Distribution of Current Data to Resource Management Components by 
providing current performance and status information, either periodically or 
on request. 

Distribution of Historical Data to Resource Management Components, thus 
providing historical performance and status information on request. 

It will be appreciated that the functional group FGI makes these determinations by 
(or while) providing; 

Common Monitored Data Set and Formats, which permits functional group 
FGI to gather the same set of statuses and statistics in the same formats for 
each host regardless of machine architecture or operating system. 
Minimally-Intrusive Data Collection Mechanisms, which permits functional 
group FGI to gather the information in as non-intrusive a manner as possible 
(in terms of CPU utilization, network bandwidth utilization, etc .). 
Near Real-Time Data Collection Mechanisms, which permits functional 
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determine the proper mapping at run-time) can be defined. The subsystem also 
provides application fault detection capabilities which are triggered by the 
unexpected death of an application that was started by the subsystem. A basic host 
fault detection capability is also provided which is triggered based on failure to 
receiv e heartbeat messages from subsystem components running on a particular host. 



FG*- Displays. The display subsystem provides capabilities for visualizing the status, 
performance, and health of the hosts, networks, and applications in the distributed 
environment Capabilities are also provided for visualizing the status, performance, 
and health of the Resource Management components themselves. 

As mentioned above, the RMComms middleware package provides the internal 
message passing interfaces between substantially all of the Resource Management functions 
both within each functional group and between the various functional groups. The 
middleware provides for automatic location-transparent many-to-many client-server 
connections. Low-overhead, reliable message passing capabilities are provided. Registration 
of message handler callback functions for specified requested message types is provided with 
the message handler functions being invoked when messages arrive. Registration of 
connection status callback functions, which are invoked when either new connections are 
made or existing connections are broken, is also provided. The middleware package also 
allows for multiple client and server objects to be instantiated in the same application, is 
thread-safe, and provides an easy-to-use object-oriented API through which all capabilities 



A detailed overview of each functional group and each function instantiated within 
each of the function groups FGI - FG6 of the exemplary embodiment of the Resource 
Management Architecture illustrated in FtgFIGS. 22 A. 2B. including the capabilities 
provided by the functional group or function, will now be described in greater detail. The 
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group FGI to gather the information in as timely a manner as possible. 

The Host and Network functional group FGI includes the four functions set forth below: 

1) Host Monitors FG10A - FGI ON, which reside on each respective machine 
in the distributed environment and collect extensive operating system-level 
data for each host A • N. 

2) History Servers FG12A • FG12N, which collect data from the Host 
Monitors FGI OA - FGI ON, respectively, maintain status and performance 
histories on each host A - N in the distributed environment, i.e., in the 
Resource Management Architecture, and provide this information to displays 
and other functions with the Resource Management Architecture. 

3) Host Discovery Function FG 1 4, which uses Simple Network Management 
Protocol (SNMP) calls and ping Internet Control Message Protocol (ICMP) 
calls to determine when new hosts, Eeg., host N+l, come on-line and if an 
existing host, e.g., host K, goes down. 

4) Remos Network Data Broker Function FG 1 6, which collects information 
on network link band widths from the SNMP-bascd Remos tool (developed 
by Carnegie Mellon University) and passes this information to the Host Load 
Analyzer function of the Resource Allocation Decision-Making functional 
group FG4, both of which are discussed in greater detail below. 

Host monitors FGI OA- FGI ON, which monitor the status and performance of hosts 
A -N, respectively, are instantiated on each host machine within the distributed environment. 
Host Monitors FGI OA - FGI ON employ Operating system-level rrwehanisms to retrieve 
status, configuration, and performance information on each host A - N. The information 
retrieved includes: 

1 ) operating system version and machine configuration; 

2) CPU configuration, status, and utilization; 

-16- 
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3} memory configuration and usage; 
4) network configuration, status, and utilization: 
3) fdesystem configuration, status, and utilization; and 
6) process statuses including CPU, memory, network, and filesystem utilization 
for each process. 

While Host Monitors FG10A - FG10N are primarily responsible for monitoring the status 
of a particular host, they also provide information on network load as seen by that particular 
host. In the same manner, the Host Monitors FG 1 0 A - FG 1 ON also pro vide information and 
statistics concerning any remotely mounted filesj-stems, e.g.. Network File System (NFS). 

The information that the Host Monitors FG 1 OA - FG I ON collect advantageously can 
be formatted into operating system- independent message formats. These message formats 
provide a pseud o-standardizcd set of state, status, and performance information which is 
useful to other components of the Resource Management Architecture, i.e., other components 
do not have to be aware of or deal with the minor differences between data formats and 
semantics It will be appreciated thai since not all the state and performance data is available 
on every platform, in order to indicate which information is available, a group of nags are 
set in the host configuration message indicating whether specific data items are valid on a 
particular platform. 

History Servers FG 1 2 A - FG 1 2N are responsi ble for collecting information from the 
Host Monitors FG10A - FG10N and maintaining histories on the statuses, statistics, and 
performance of each host A - N in the distributed environment, This information 
advantageously can be requested by other functions i nstantiated in the Resource Management 
Architecture. Preferably, the primary consumers of the status information obtained by the 
History Servers FG 1 2 A - FG 1 2N are the Host Load Analyzer (Hardware B roker) component 
of the Resource Allocation Decision-Making functional group FG4, the Host Display FG62A 
- FG62N and the Path Display FG64 of the Displays functional group FG6. The Host Load 
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It should be mentioned that when a new host is first detected, the new host* s operating 
system configuration is queried by the Host Discovery function FG14 via SNMP calls. 
Information on the newly discovered host and its operating system configuration is then sent 
to the Program Control function FG50 in application control functional group FG5. 
Likewise, when a host fails to respond to multiple SNMP and ping queries, a message 
indicating that the host appears to have gone down is sent to the Program Control function 
FG50. 

The final component of the Host and Network Monitoring functional group FG1 is 
the Remos Network Data Broker FGI6, which receives information on network link 
bandwidth and network link bandwidth utilization from the SNMP-based Remos network 
monitoring tool mentioned above. The network information is accessed via the Remos 
application programming interface (API) library and is then sent on to the Host Load 
Analyzer (Hardware Broker) function FG40 of the Resource Allocation Decision-Making 
functional group FG4. The network information received from Remos consists of the 
maximum potential bandwidth and the current bandwidth utilization on specific host network 
links. As mentioned above, Remos network monitoring tool FG 16 is not a core component 
of the Resource Management Architecture; that being the case, no further details on either 
Remos or the Remos Network Data Broker are provided in the instant application. 

FG2 - Application- Level Instrumentation Functional Group 

The Instrumentation functional group FG2 advantageously provides general-purpose 
appl i cation event reporting and event correlation capabilities . The Instrumentation functional 
group permits instrumented application data to be easily accessible to other components of 
the Resource Management Architecture. The functional group provides capabilities for 
collecting and correlating application -provided data such as application statuses, states, 
performance, and internally detected errors. Low-overhead API's are provided that the 
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Analyzer FG40 receives information on host configuration and loads (primarily CPU, 
memory, and network data) from History Servers FG12A - FG12N and employs this 
information to assign host fitness scores. Each Host Display, e.g., FG62A, receives and 
displays current status information on one of the hosts A - N, including process status 
information, and network connectivity information. Each Host Display can also request that 
a respective one of the History Servers FG1 2A - FG12N provide CPU load information, 
network load information, paging activity data, and memory utilization information, which 
is used to drive line graph charts for specific selected hosts. 



It will be appreciated that History Servers FGI2A - FG12N are designed so that 
multiple copies can be run simultaneously. Each of the History Servers FG12A - FG12N 
advantageously can be configured to either monitor all Host Monitors or to monitor only a 
selected set of Host Monitors. It should be mentioned at this point that the History Serv ers 
FG12A - FG12N determine ihe list of hosts in the distributed environment that could 
potentially be monitored from the System Specification Library, In this manner, the History 
Servers advantageously can be used to provide survivability (by having multiple History 
Servers connected to each Host Monitor) and/or to perform load-sharing (with the History 
Servers FGI2A - FG12N each monitoring only a subset of the Host Monitors). It will also 
be appreciated that the History Servers FG12A - FG12N can be configured to periodically 
record history data to disk. These disk files can then be used for off-line anal) sis of the 
Resource Management Architecture. 

The Host Discovery function FG14 employs Perl scripts in making SNMP and 1CMP 
ping calls. These calls are used to periodically scan each subnet and host address in the 
distributed environment in an attempt to determine whether there have been any host status 
changes. In an exemplary case, the list of hosts and subnets thai are to be monitored is read 
in from a file; alternatively, this information can reside in and be read from the System 
Specification Library, which is discussed in greater detail below. 
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applications can use for sending internal event and performance data to the instrurnenLation 
components. The instrumentation functional group FG2 can collect data from applications 
on hosts A - N throughout the distributed environment. The functional group also provides 
grammar-driven capabilities for correlating, combining, and reformatting application data 
into higher-level metrics (composite events) for use by displays or other functional groups 
of the Resource Management Architecture. 



The Instrumentation functional group provides: 

open API's and non-proprietary architecture 
near real-time monitoring support 
cross-language support: C, C++, Ada 
cross-platform support: Solaris, IRIX, Linux, etc... 
simple easy-to-use API's 
low-intrusive instrumentation interface 

instrumentation interface that does not significantly change the run-time 
behavior of the applications 
support for passing wide range of data types 

support for data marshalling / unrnarshalUng (system independent data 
formats) 

support for adding to or changing the information being instrumented without 
having to recompile portions of the architecture unaffected by the changes 
(preferably, no recompilation should be necessary expect for recompilanon 
of the app being instrumented and any ev aluation logic or displays that have 
been affected by the changes) 

scalable architecture (1 00+ hosts/ 20- apps per host/ S+ threads per app) 
ability for the architecture to perform autc-conftguration as required 
ability to run multiple tests, multiple displays and multiple data logging 
components simultaneously 
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* ability to abstract aw sty the ujidertyingconnectiviry/communicalions between 
infrastructure components 

ability for instrumentation infrastructure to be brought up and down while the 
application is running 

ability' to easily build and configure new- displays and data logging 
components (interactive configuration is preferable) 

* ability to easily build and configure new performance and data correlation 
components (interactive configuration is preferable) 

backwards compatibility with existing Jewel Instrumentation displays 
(protect investments in existing display capabilities) 

* backwards compatibility with existing Jewel Instrumentation function calls 
(provide ease of transition / backfit) 

As illustrated in FigFlGS. 22A, 2B, the Instrumentation functional group FG2 
includes the components enumerated below. In addition, Instrumentation APIs and Jewel 
Instrumentation will be addressed along with the Instrumentation functional group, i.e., the 
Instrumentation functional group includes: 

I) Instrumentation API Libraries FG20 are linked with the applications and 
provide the function call interfaces by which these applications send 



2) 



i FG22A - FG22N reside on each host in the 
distributed environment and are responsible for reading instrumentation data 
sent out by the applications, reformatting the data into instrumentation event 
messages and sending the messages to the Instrumentation Collectors. 
Instrumentation Collectors FG24 A -FG24N connect to the Instrumentation 
Daemons FG22A - FG22N on each host and receive instrumentation 
messages from host A -N. The Collectors forward received messages to the 
Instrumentation Correlators FG26A - FG26N and Instrumentation Brokers 
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compatibility with existing instrumented application code and is implemented as a set of 
wrappers around the printf()- style API. All three APIs are supported for C and C++. ADA 
bindings have also been produced for the buffer-construction-style API and the Jewel 
function call API. 

Preferably, the instrumented data is sent from the application to one of the 
Instrumentation Daemons FG22A -FG22N on a respective one of the hosts A - N where the 
application is running. The currently preferred mechanism for data transfer is via UNIX FIFO 
(first in - first out) IPC (inter-process communication) mechanisms. It will be appreciated 
thai the FIFO mechanism was chosen based on reliability, low overhead, and ease of 
implementation Alternative data passing mechanisms including shared message queues are 
considered to be within the scope of the present invention. 

As mentioned above, an Instrumentation Daemon resides on each host in the 
distributed environment. The Instrumentation Daemon is interrupted whenever new data is 
written to the FIFO The Instrumentation Daemon reads the data from the FIFO, reformats 
the data into the standard internal Instrumentation message format (discussed below), and 
sends the data to each of the respective Instrumentation Collectors FG24A -FG24N that are 
currently active. Alternatively, an event request filtering mechanism can be implemented so 
that specific event messages will only be sent to those ones of the Instrumentation Collectors 
FG24A -FG24N that have requested the message. 

The standard instrumentation message format includes a header, a format string 
describing the application-provided data contained in the message, and the actual data values 
The message components are illustrated in Attached Appendix B. 

The Instrumentation Collectors FG24A- FG24N receive instrumentation messages 
from the Instrumentation Daemons FG22A - FG22N on each host A - N, respectively, in the 
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FG28A - FG28N. 

4) Instrumentation Correlators FG26A - FG26N receive instrumentation 
messages from the Instrumentation Collectors FG24A - FG24N and provide 
grammar-driven capabilities for correlating, combining, and reformatting 
application data into higher-level metrics (composite events) for use by 
displays or other functions of the Resource Management Architecture. 

5) Instrumentation Brokers FG2SA - FG28N receive instrumentation 
messages from the Instrumentation Collectors and perform task-specific 
reformatting and data manipulation for driving display? or other Resource 
Management components. 

6) JewellnstruinenUtionBraker(QoSMoiiltor>FG29(alegacy component) 
receives instrumentation data from either the open source Jewel 
instrumentation package or from the Instrumentation Collectors. The QoS 
Monitor FG29 performs task-specific message reformatting and data 
manipulation for driving displays and the QoS Managers FG44A - FG44N. 

The applications, e.g . Al-AN, link in the Instrumentation API Library FG20 and 
make API calls to construct and send out instrumentation event messages. Three separate 
APIs are provided for use by the applications: 

1) a printfO-style API which allows the code to format, build, and send 
instrumentation data with a single function call; 

2) a buffer-«onstruction-st>1e API where the multiple function calls are made to 
construct the instrumentation buffer iterative!)-, one data element per call: and 

3) a Jewel function call API based on the existing API provided by the Jewel 
instrumentation package (an open-source package produced by the German 
National Research Center for Computer Science). 

The first two APIs are (he preferred prograrnrning interfaces and take advantage of several 
key instrumentation features while the Jewel API is provided solely for backwards 



distributed environment. Currently, the Instrumentation Collectors FG24A- FG24N send 
every instrumentation message to all Instrumentation Brokers FG29A- FG29N and 
Instrumentation Correlators (Brokers) FG26A- FG26N that have connected to the 
Instrumentation Collectors FG24A- FG24N. The Instrumentation Collectors FG24A- FG24N 
serve as a pass-through serv er for instrumentation messages. The Instrumentaiion Collectors 
do support architecture scalability in the sense that without the Instrumentation Collectors, 
the Instrumentation Broker FG29 and Instrumentation Correlators FG26A- FG26N would 
need to maintain connections to the Instrumentation Daemons FG22A- FG22N on every 
host. As discussed above, an event request filtering mechanism advantageously can be 
implemented so that specific event messages will only be sent to those Instrumentation 
Brokers / Instrumentation Correlators that have requested the message. 

Preferably, the Instrumentation Correlators FG26A- FG26N provide grammar-driven 
capabilities for correlating, combining, and reformatting application data into higher-level 
metrics (composite events) for use by displays or other components of the Resource 
Management Architecture. Each CorreJ ator reads in a user-specified correlation grammar file 
which is interpreted at run-time by the Correlator's instrumentation correlation engine. 

The Instrumentation Brokers FG28A- FG2SN are task-specific applications built 
around a common code package. The Instrumentation Brokers FG28A- FG28N receive 
instrumentation messages from the Instrumentation Collectors FG24A- FG24N, filter all 
received instrumentation messages to find the messages of interest, and perform task-specific 
message data reformatting and manipulation for driving other components such as displays 
or other components of the Resource Management Architecture. This lnstrurnentation Broker 
approach permits instrumentation data sources to be quickly integrated for test, display, and 
ig purposes 



It should be mentioned at this point that the Jewel Instrumentation Broker FG29 
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(hereafter referred to the QoS Monitor) is a legacy architecture component thai served as a 
broker between the Jewel instrumentation package components and Resource Management 
components and displays The QoS Monitor FG29 was responsible for polling the Jewel 
Collector components to retrieve application event messages. These messages were then 
reformatted and used to drive several displays and the QoS Managers FG44A - FG44N. The 
Jewel instrumentation package has now been replaced in all applications, however the 
message reformatting capabilities of the QoS Monitor have been maintained so that several 
displays and the existing QoS Manager interface do not have to be upgraded immediately. 
The QoS Monitor component has been modi fied so that it recei v es instrumentation data from 
both Jewel and the Instrumentation Collectors. 

FC3 - SYSTEM SPECIFICATIONS FUNCTIONAL GROUP 

Still referring to FrgFIGS. 22A. 2B, it should be noted thai a System Specification 
Language has been developed which allows the user to specify both (1) software system 
structure, capabilities, dependencies, and requirements, and (2) hardware system (computer 
and network) structure, capabilities, and configuration. System Specification Files, generalry 
denoted FG32, which are based on this specification language, are created by the user and 
provide a model of the software and hardware components of the distributed computing 
environment which is used by the Resource Management Architecture. The language 
grammar advantageously can capture the following information related to the distributed 
environment and the applications that can run within the distributed environment: 
Hardware and Operating Systems 
Hardware Configuration 
Network Configuration 
Operating Systems and Version 
Software 

Systems, Subsystems, Paths, Applications, Processes 



scalability capabilities of the application can be specified. This latter information includes 
whether an application can be restarted if it fails, whether multiple copies of an application 
can be run, what type of scalability the application supports (e.g., Primary-Shadow, Load- 
Sharing, etc.), and the minimum and maximum number of copies that can be run. 
Moreover, an estimate of the amount of CPU, memory, and network resources that the 
application will use at run- time, advantageously can be specified. 

At the host level, the operating system and version, the hardware architecture, the 
host's network interface name, and the SPEC organization's SPECfp« and SPECint95 
ratings for the host can be specified. At the network level, router and switch configurations 
and band widths can also be specified. 

Moreover, application data flow paths can be defined including a graph of the data 
flow between applications along with performance requirements tied to one of more of the 
applications within the path. It should be mentioned that these denned requirements are 
named and are tied at run-time to Instrumentation Event data provided by the Instrumentation 
Correlators FG26A- FG26N. Monitoring of the performance requirements is the 
responsibility of the QoS Manager components FG44A - FG44N, as discussed in greater 
detail below. 

As noted above, the System Specification Language provides a hierarchical structure 
for defining software and hardware systems. The current structure is shown below: 
Software Specifications 
Application 

Security 
Configuration 

Hardware Requirements 
Startup Info 



-27- 



Resource Requirements 
QoS Requirements (Events) 
Survivability Requirements 

Data Flow Path Information: Structure and QoS Requirements 



Dynamic Arguments 
Shutdown Info 



It will be appreciated that the Systen 



n Language allows for grouping 



hardware and software components into systems and subsystems in order to create a 
hierarchy of components. Each application system and subsystem can be assigned a priority 
which is used at run-time to determine the relative importance of applications running in the 
distributed environment. 

At the application level, the hardware, operating system, and other host requirements 
for each application can be specified along with information describing how to start up, 
configure, and shutdown the application. This information can include: 

a) environment variables that need to be set; 

b) the working directory for running the application; 

c) the path(s) and file name of the application; 

d) command-line arguments that should be set, including arguments that need 
to be resolved at run-time (e.g., the hostname where another application is 
running, the current date, the current userid, a unique run-time identifier 
number, etc...); 

e) whether the application needs to run in an xterm; 

f) whether a script file or signal should be run to shutdown the application; and 

g) which script or signal should be used. 

In addition, startup and shutdown dependencies between applications can be specified. 
Moreover, application states can be defined based on received instrumentation data values, 
the length of time an application has been running, and/or the set of processes that are 
currently running. Furthermore, for each application Al - NM, the survivability and 



Dependencies 

Initial Load Estimate 

QoS Info 

Survivability 
Scalability 
« Specifications 



Host Info 
Network Info 
LANs 

Network Devices (Interconnects) 
Path Specifications 

Data Flow Graph 
Data Flow Info 
QoS Requirements 



The specification information is accessed by linking in a specification parser library 
FG34 and making library calls to read in the files and convert them to an internal object 
model, and by making object access method calls to retrieve specific data items. The 
specification library is written in C++ and has been ported to all of the development 
platforms in the testbed. The library' is currently being used by most of the Resource 
Management components, including Program Control FGSO, the Resource Manager FG42, 
the QoS Managers FG44A -FG44N, the Hardware Broker FG40, and the History Servers 
FG12A - FGI2N. 

It should be mentioned that the software used to construct the API library consists of 





• 
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• 




(1) a parser file that defines the grammar (in BNF formal), (-2) a lexical analyzer file that 






started (or shut down) prior to starting (or shutting down) a particular 




defines the tokens of the language, and (3) a set of C++ System Specification classes for 






application 




storing the specification file information. The lexical analyzer file is compiled with the GNU 






Based on startup and shutdown dependency resolution requests from Program 




flex flex) utility and the parser file is compiled using the GNU bison (yacc) utility. The flex 






Control, determine whether and where additional applications should to be 


5 


and bison utilities create C source files which are then compiled along with the C++ System 


5 




Started (or shut down) prior to starting (or shutting down) a particular 




Specification object storage classes to create the System Specification Library (S5L) FG34. 






application 




This library is then linked with the Resource Management applications An overv iew of this 










structure is provided in FrglG. 3; a more detailed discussion of the various functions arc 






defined in the System Specification Files, determine whether applications are 




provided below. 






meeting performance requirements and whether an application can be scaled 


10 




10 




up or moved to attempt to improve performance 




FG4 - RESOURCE ALLOCATION DECISION-MAKING FUNCTIONAL CROUP 






Based on application instrumentation data and performance requirements 










defined in the System Specification Files, determine whether applications are 




As illustrated in frgRGS. 52A, 2H, the Resource Allocation Decision-Making 






performing well within performance requirements and can be scaled down 




functional group provides the reasoning and decision-making capabilities of the Resource 






Based on operator changes to application system priorities, determine 


15 


Management architecture. The functions associated with this functional group employ 


IS 




whether and where new applications need lo be started and/or determine 




information (listed below) to (1) determine the state and health of the distributed 






whether and which existing applications need to be shutdown 




environment (hosts, networks, and applications), and (2) determine what allocation and 






Based on indication that a new host is on-line (from Host Discovery via 




reallocation actions need to be taken. The information provided to functional group FG4 






Program Control), issue startup orders to bring up a Program Control Agent, 




includes: 






Host Monitor, and Instrumentation Daemon on the new host which will bring 


20 


System Specifications: 


20 




the host under Resource Management control 




Host configuration and capabilities 










Application capabilities 




The Resource Allocation Decision-Making functional group implements one of the 




Survivability 




three discreu 


s functions listed below: 




Scalability 




I) 


Resource Manager FG 4 2 is the primary decision-making component of the 


25 


Potential hosts to run on 


25 




Resource Management Architecture. Resource Manager FG42 is responsible 




Application startup and shutdown dependencies 






for determining ( 1 ) ho w to respond to host and application failures, (2 ) where 




Application and path performance requirements 






to place new applications. (3) which applications to start up in response lo the 




Program Control: 






detection of a new host, (4) how to resolve application dependencies, (i) 
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Application statuses 






what applications should be started, stopped, or moved in response to 




Detected application faults 






application system priority changes, and (6) based on recommendations from 




Detected host failures 






the QoS Managers FG44A - FG44N, when and where scalable application 




Detection o f new host 






should be started or stopped. 


5 


Operator initiated requests 


5 


2) 


Host Load Analyzer FG40 is responsible for assigning a set of fitness scores 




Resolution of application startup or shutdown dependencies 






to each host based on host capabilities and loads. 




Selection of application-to-host mappings 




3) 


QoS Managers FG44A -FG44N are responsible for monitoring application 




History Servers 






and path requirements as defined in the System Specification Files FG32 and 




Host statuses, configuration, and loads 






recommending that applications be either scaled up, scaled down, or moved 


10 


Network link statuses and loads 


10 




in order to maintain acceptable performance. 




Ratios Network Data Broker 










Network link statuses and toads 




As mentioned above, the Resource Manager FG42 is the primary decision-making 




Instrumentation Subsystem: 




component of the Resource Management Architecture. It is responsible for: 




Application performance information 




(1) 


responding to application and hosi failures by determining if and what 


IJ 


Readiness Display: 


IS 




recovery actions should be taken; 




Run-time changes to application system priorities 




<2) 


determining if and where to place new copies of scalable applications or 










which scalable applications should be shutdown when the QoS Managers 




The subsystem components make decisions based on the following triggers and data 






indicate that scale-up or scale-down actions should be taken based on 




sources: 






measured application performance; 


20 


Based on requests from Program Control, determine where new applications 


20 


(3) 


determining where new applications should be placed when requested to do 




should be Started 






so by Program Control; and 




Based on indication of application failure from Program Control, determine 




(4) 


determining which and how many applications should run based on 




whether and where the failed applications should be restarted 






application system (mission) priorities. 




Based on indication of host failure from Program Control (or indirectly from 








2J 


Host Discovery), determine whether and where the failed applications should 


2J 


In order to accomplish these tasks, the Resource Manager FG42 maintains a global 




be restarted 




view of ihe 


!taxe of the entire distributed environment including status information on all 




Bssed on application inter -dependencies defined in the System Specific&lion 




hosts A- N, networks 100, and applications Al -NM, In addition, the Resource Manager 




Files, determine whether and where additional applications should to be 




FG42 also c 


ilculates software and hardware readiness metrics and reports these readiness 
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values, for display purposes, to the display functional group FG6. 

II will be appreciated from FigFIGS. 52 A, 28 thai the Resource Manager FG42 
receives status and fail lire information about hosts, networks, and applications from Program 
Control function FGSO. This information includes both periodic status updates and 
immediate updates when statuses change such as a new host being detected or an application 
failing. In the case of application shutdown, information as to whether the application was 
shutdown intentionally or whether the application failed is also provided. Program Control 
function FG50 also issues requests to the Resource Manager FG42 when new applications 
need to be dynamically allocated and when the Program Control function FGSO determines 
thai the Resource Manager FG42 needs to assess and attempt to resolve inter-application 
dependencies (such as one application which needs to be running prior to starting up another 
application). 

The Resource Manager FG42 responds lo faulted applications and hosts by 
determining whether the failed applications can and should be restarted and attempting to 
determine where (and if) there are hosts available that the application can run on. When a 
decision is made by the Resource Manager FG42, a message is sent to Program Control 
FG50 specifying what application to start and where to put it, i.e., which of hosts A - N to 
start the application on The same general mechanism is used when Program Control FGSO 
requests that the Resource Manager FG42 determine where to start new applications and/or 
how to resolve intcr-application dependencies; the Resource ManagerfG42Manager FC42 
responds with orders indicating what applications to start and where to start them. The 



Resource Manager FG42 advantageously can send application shutdown ii 
Program Control FG50 requesting that a certain application be stopped; this can occur when 
the QoS Managers FG44A-FG44N indicate that certain scalable applications have too many 
copies running or when application system priority changes (when an application changes 
from a high priority to a lower priority) occur resulting in scaling back the application system 



The Resource Manager FG42 currently responds to application system priority 
changes received from the Readiness Broker (translation software in or associated with the 
Readiness Display FG66) in the following manner: 

(1) If the priority is changed to None, all applications associated with the 
specified system are shutdown. 

(2) If the priority is changed to Low, all scalable applications within the specified 
system are scaled back to no more than 50% of potential maximum 
scalability and are not allowed to be scaled up past the 50% limit irregardless 
of performance. 

(3) If the priority is changed to Medium, normal scaleup and scaledown 
functionality is allowed. 

(4) lfthepriorityis changed to High, all scalable applications are scaled up to at 
least 50% of potential maximum scalability and are not allowed to be scaled 
down to less than 50% irregardless of performance. 

(5) If the priority is changed to Urgent, alt scalable applications are scaled up to 
100% (for maximum survivability) and are not allowed to be scaled down. 

[Moreover, if the prev ious priority was None, and the new changed priority is higher than 
None, all required applications within the specified system are started up subject to the 
limitations outlined for each of the priority levels listed above.) 

The Resource Manager FG42 also sends information about allocation and 
reallocation decisions to the Resource Management Decision Review Displays FG68A- 
FG6SN, as discussed in greater detail below. Information on the decision that was made, 
what event the decision was in response to. and how long it took to both make the decision 
and impl ement the decision advantageously are also sent to the display functional group FG6. 
In addition, information about the alternative choices for where an application could have 
potentially been placed is also provided (if applicable); in an exemplary case, this 
information includes the host fitness scores for the selected host and the next best host 
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configuratton. 

The Resource Manager FG42 also receives host load and host fitness information on 
all known hosts from the Hardware Broker (Host Load Analyzer) FG40. This information 
includes (1) overall host fitness scores, (2) CPU-based fitness scores, (3) network-based 
fitness scores, and (4) memory and paging- based fitness scores, along with (5) the SPEC95™ 
rating of the hosts. These scores are used by the Resource Manager FG42 for determining 
the "best" hosts for placing new applications when: 

( 1 ) responding to requests from the QoS Managers to scale up additional copies 
of an application; 

(2) attempting to restart failed applications; 

(3) responding to requests to dynamically allocate certain applications; and 

(4) responding to application system (mission) priority changes which require 
scaling up additional applications. 

The Resource Manager I'G 4 2j1w FG42 also receives requests from the QoS Managers 
FG44A-FG44N for scaling up, moving, or scaling down specific applications. The Resource 
Manager FG42 responds to these requests by determining whether the request should be 
acted upon and, if so, determines the specific action to take. The Resource Manager FG42 
then issues orders to Program Control FG50 to start up or shutdown specific applications on 
specific hosts. 

It should be noted that when the Resource Manager FG42 is first started, it reads in 
the System Specification Files FG32 (via calls to System Specification Library FG34) which 
contains the list of hosts that are known to be associated with the distributed environment 
and information on all applications that can be run in the distributed environment. The 
application -lev el information includes where, i.e., on which host, specific applications can 
be run, which applications are scalable, which applications can be restarted, and any 
dependencies between applications 
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choices which could have been selected. 

As described above, the Resource Manager FG42 communicates with Program 
Control FGSO, the Hardware Broker FG40, the QoS Managers FG44A -FG44N, QoS 
Specification Control (not shown), the Readiness Broker of display FG66, the Globus Broker 
(e g., message translation software (not shown)), and the RM Decision Review Displays 
FG68A- FG68N using the RMComms middleware, which will be discussed in greater detail 
below. 

The Hardware Broker (Host Load Analyzer) FG40 is the host load analysis 
component of the Resource Management Architecture, which is primarily responsible for 
determining the host and netw ork loads on each host A - N within the distributed computing 
environment The Hardw are Broker FG40 assigns a set of fitness scores for each host and 
periodically provides the list of fitness scores to the Resource Manager FG42. 

The Hardware Broker FG40 advantageously receives operating system-level statuses 
and statistics for each host A- N from the History Servers) FG12A-FG12N, respectively. 
This information can be employed for calculating CPU, network, memory, paging activity, 
and overall fitness scores for each of the hosts A-N. Preferably, the Hardware 
Dr e ke r rWO Broker FG40 periodically, e.g. once per second, provides the complete list of 
host fitness scores to the Resource Manager FG42. 

It should be noted that when the Hardware Broker FG40 is first started, it reads in the 
System Specification Files FG32 (via calls to the System Specification Library(SSL) FG34), 
which files contain the list of hosts that are known to be in the distributed environment The 
Hardware Broker FG40 also receives, e.g., reads in a file containing, information about the 
bandwidth and maximum packet sizes on all known network subnets in the distributed 
environment. It will be appreciated that this data advantageously can be used for converting 
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host network load information based on packet counts to load information based on bytes per 
second and percentage of available bandwidth. 

Periodically, e.g., approximately every three seconds, the Hardware Broker FG40 
transmits a list of overall and network host fitness scores to the Hardware Broker 
Instrumentation Display which was constructed using the Graph Tool Instrumentation 
Display FG69A-FG69N. Moreover, the Hardware Broker FG40 advantageously can receive 
host-based network load data from the Remos Network Data Broker function FG16, which 
receives network data via the Remos Network Monitoring software 2. It should be noted that 
if Remos network data is available for any of the hosts A -N that are being monitored, the 
Remos reported network data advantageously can be used for calculating the netw ork fitness 
score for that host, rather than using the host network data received from the History 
Server(s)FG12A-FGl2N. 

The QoS Managers FC44A - FG44N of functional group FG4 are responsible for 
monitoring application-level performance requirements. These requirements are defined in 
the System Specification Files FG32 and are monitored primarily via instrumentation data 
obtained directly from the application code. The QoS Managers FG44A - FG44N 
advantageously can determine if applications or application paths are meeting their assigned 
requirements. If an application is not meeting its performance requirements and the 
application is scalable (in the sense that multiple copies can be run and the copies will 
perform load-sharing across the copies), the QoS Managers FG44A - FG44N will either 
request that the Resource Manager FG42 scale up a new copy of the application or move the 
application to a new host (as an attempt to achieve better performance). Moreover, if there 
arc multiple copies of a scalable application running, and all copies are performing well 
below the specified requirement threshold, the QoS Managers FG44A - FG44N will request 
that the Resource Manager FG42 shutdown a specific copy. It should be noted that the 
division of responsibility between the QoS Managers FG44A - FG44N and the Resource 
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Any of the QoS Managers FG44A - FG44N can also request that the Resource 
Manager FG42 move an application. This will occur in the case where one copy of an 
application is performing much worse than all other running copies of the same application. 
In an exemplary case, the move request is implemented as a scale up request followed by a 
scale down request (of the badly forming copy). In that case, the scale down request does 
not get sent to the Resource Manager FG42 until the scale up action has been implemented. 
The QoS Managers FG44A - FG44N preferably employ application "settling times," defined 
in the System Specification Files FG32, to ensure that once a requested action has been sent 
to the Resource Manager FG42 that no additional actions are requested for that application 
until after the settling time has elapsed. It will be appreciated that this provides lime for 
initialization and configuration among the application copies to occur. Alternatively, System 
Specification Language inter-application dependency definitions adv antageously can be used 
instead of settling times. 

The QoS Managers FG44A - FG44N also receive application status and state 
information from Program Control FG50, which periodically sends application status updates 
for all running applications and also sends immediate indications of any applications which 
have been started or stopped. This information is used by the QoS Managers FG44A - 
FG44N, along with the instrumented performance data being received via the QoS Monitor 
FG29 and Instrumentation Correlator FG34, to determine the exact state of all monitored 
applications that are running. This information is also used to determine when (and if) 
requested actions have been implemented by the Resource Manager FG42. The information 
is also used for setting up and discarding internal data structures used for monitoring the 
performance of each appl tiatiui i A 1 - N M iippl ication A 1 -NM. 

It will be appreciated that the QoS Managers FG44A - FG44N also receive 
application-level instrumentation data indicating current application performance values 
from the Instrumentati on Correlators (Brokers) FG26A -FG26N, the Instrumentation Brokers 
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Manager FG42 is that the QoS Managers determine what actions would potentially improve 
performance, while the Resource Manager has final authority to determine whether to 
implement the requested action(s) 

Each of the QoS Managers FG44A - FG44N can be scaled for both redundancy and 
for load-sharing. In an exemplary case, each copy of the QoS Manager monitors all of the 
requirements associated with a single application path defined in the System Specification 
Files FG32. It will be appreciated that the specific path to be monitored can be specified via 
command-line parameters. By default, without specifying a path via the command-line, the 
QoS Managers FG44A - FG44N will monitor all requirements for all paths defined in the 
System Specification Files FG32. 



It should be mentioned that, in one exemplary embodiment, the C 
FG44A - FG44N each employ a sliding window algorithm to determine when to declare that 
appl icatio ns should be scaled up or scaled do wn. The inputs to the algorithm define both high 
and low sampling window sizes, the maximum number of allowed violations within the 
sampling window, and violation thresholds as a percentage of the actual specified 
requirement value. It should also be mentioned that the sliding window algorithm was 
selected in order to damp out unexpected "noise" or "spikes" in the measured performance 
data. Moreover, the threshold value as a percentage of the actual requirement value was 
selected in order to scale up, or scale down, prior to violating the specified hard requirement. 
The QoS Managers FG44A - FG44N provide application scale up and scale down requests 
to the Resource Manager FG42 when the measured performance data for an associated 
application violates either the high (scale up) or low (scale down) sliding window criteria for 
a specific requirement. A scale up request indicates which application on which host has 
violated the performance criteria, and a scale down request indicates which application on 
which host is recommended to be shutdown. It will be appreciated that the success of this 
algorithm is highly dependent on the rate of change and noisiness of the measured data. 
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FG28A-FG28N, and/or the Jewel Instrumentation Broker (QoS Monitor) FG29. The 
instrumentation data that is received contains (at a minimum) ( 1 ) the timetag when the data 
was generated, ( 2) the hostname and IP address of the host where the application that the data 
is associated with is running, (3) the process id (pid) of the application that the data is 
associated with, and (4) the event number of the instrumentation message. Preferably, the 
event number of the instrumentation message specifies the type of instrumentation data that 
has been received; the hostname, IP address, and pid are used, in conjunction with the 
application data received from Program Control FG50, to determine the specific application 
thai the data is associated with. 

When the contents of the instrumentation message match any of the application 
performance requirements that are currently being monitored by the QoS Managers FG44 A - 
FG44N, the data value is added to the proper requirement sliding window for the specified 
application. The sliding window algorithm is then checked to determine if the new sample 
triggered a violation of either the high or low sliding window. If a high threshold sliding 
window violation occurs and the application does not already have the maximum number of 
copies running, adeterrnination is made as lo whether performance can be best improved by- 
starting a new application (scale up) or by moving an existing copy to a different host. The 
corresponding action recommendation will then be sent to the Resource Manager FG42. In 
an exemplary case, the criteria for determining whether an application should be moved 
rather than scaled up is based on relative performance of the replicated applications. More 
specifically, if one application is performing much worse |> 50%) than the other copies, the 
recommendation will be to move the application. Likewise, if the new sample triggers a low 
threshold sliding window violation and the application has more than the minimum number 
of copies running, a recommendation will be sent to the Resource Manager FG42 requesting 
that the copy of the application that is experiencing the worst performance be scaled down. 

FG5 - RESOURCE (APPLICATION) CONTROL FUNCTIONAL GROUP 
-40- 



As discussed above, the Resource Control capabilities provided by the Resource 
Management Architecture consist of controlling application startup, configuration, and 
shutdown on hosts within the distributed environment. This capability, known as Application 
Control or Program Control (hereafter referred to as Program Control) provides a powerful 
distributed configuration capability, The Program Control capabilities permit an operator to 
startup and control applications running on platforms throughout the distributed environment 
via an easy-to-use interactive display. These capabilities are provided by the Application 
Control functional group FG5. 

More specifically, the Application Control functional group provides application 
control (i.e., Program Control) capabilities which permit starting, stopping, and configuring 
applications on each of the hosts in the distributed environment The functional group 
pro v-i d K both interactive operator control of the distributed environment as well as automatic 
control via configuration orders received from the Resource Allocation Decision-Making 
functional group FG4, i.e., the Resource Manager component. The interactive controls allow 
an operator to create, load, save, and edit pre-defined system configurations, e.g., lists of 
applications that are to be run, with or without specific host mappings, determine the status 
and configuration of currently running programs, and start and stop any or all applications. 
Both static (operator-entered) mappings of applications to hosts and dynamic mappings of 
applications to hosts (where the Resource Allocation Decision-Making functional group FG4 
wil I be queried to determine the proper mapping at run-time) advantageously can be defined. 
The functional group also provides application fault detection capabilities which are 
triggered by the unexpected death, i.e., fault, of an application that was started by the 
functional group. A basic host fault detection capability is also provided which is triggered 
based on failure to receive heartbeat messages from functional group components running 
on a particular host. 



Resource Manager FG42. 



d Control Displays FG54A - FG54MN - serve as the GUI for 
interactive control of distributed applications. The Program Control Displays 
FG54A - FG54MN allow an operator to see and control the status of 
applications running on each host in the distributed environment. The 
Program Control Displays FG54A - FG54MN also provide the user the 
ability to determine the status of each of the components of the Program 
Control architecture. Predefined scenario configurations defined in Program 
Control Configuration Files FG56 advantageously can be loaded and edited 
via the Displays. It should be mentioned that new Program Control 
Configuration Files can also be created and saved via the Displays. As 
illustrated in FrgFlGS. 52A, 2B, Program Control Displays FG54A - 
FG54MN can be run simultaneously with application status changes being 
reflected at each display. 

Configuration Files FG56 • contain an ordered set of applications that can 
be loaded at the Program Control display and then either edited or executed. 
The Configuration Files can contain both dynamic and static applicauon-to- 
host mappings. For static application-to-host mappings, an application will, 
by default, be started on a specified host For dynamic application-to-host 
mappings, the application will have a default host to start on but the Resource 
Manager FG42 will be queried at run-time to determine where the application 
actually should be placed. The Configuration Files FG56 also contain all 
information on how to start, stop, and configure an application, with the 
exception of environment variable settings for the application wnich are set 
based on the System Specification Files FG32. 



A brief description of each function provided by the functional group FG5 is provided 
below; a detailed discussion of the Resource Control functional group FGS and associated 
data flow will be provided in discussing FiglG. 4. 



I) Program Control Agents FG52A- FG52N: A Program 
Control agent generally denote D IH j. '- i J FG52 resides on each 
of the hosts A-N (i.e., PCA - PCN). Each agent is responsible 
for providing direct control over application startup and 
shutdown of applications on its respective host. The agent 
receives control orders from the Program Control function 
FG50 and ts then responsible for implementing the orders In 
an exemplary case, the agents implement the orders via 
system call mechanisms specific to the particular operating 
system In addition, the agent also provides feedback to the 
Control function FG50 regarding the current status of all 
applications running on a particular host. 



Program Control FG 50 - maintains the application state information for the 
Program Control functional group FGS. It also serves as the decision-making 
component of the Program Control functional group. The Control function 
FG50 receives application control (startup, shutdown, or configuration) 
requests from the Program Control Displavs FG54A - FG54N and from the 
Resource Management functional group FG4. Using information from the 
Specification Files FG32, these high-level control function requests are 
dynamically translated into specific control orders which are sent to Ihe 
individual Program Control agents FG52A -FGS2N, The program Control FG 
50 also provides application status and configuration information back to the 



It should be mentioned here that the Program Control functional group employs the 
application startup and shutdown information defined in the System Specification Files 
FG32. When an application entry is first created interactively at one of the Program Control 
Displays FG54A - FG54N, all of the startup and shutdown information for that application, 
as specified in the System Specification Files FG32. are loaded in as default settings, Once 
a configuration file entry has been created, all configuration information on the application 
is read in from the configuration file except for the application environment variable settings 
which are still set based on the System Specification Files FG32. 

As mentioned above, a Program Control agent resides on each host. The agent is 
responsible for providing direct control over application startup and shutdown. The agent 
receives control orders from the Control component and is then responsible for implementing 
the orders. Each of the PC Agents FG52A - FG52N implements application startup and 
shutdown orders via system call mechanisms specific to the particular operating system of 
the host For example, on the Unix platforms, to start an application, the fork() and execv() 
function calls are used to create the application. The csh command is executed to start up the 
applications. Moreov er, if the application needs to run in a console, an xterm is configured 
for the application to run in. In addition, if logging of either stdout or stderr is specified, the 
proper redirection operators are configured and the output log file is set to 
7usr/tmp/<userid>_<appname>_<pid> log*. All environment variables needed by the 
application are also configured and passed in at the execv() call. The current working 
directory' is also set by the chdirf) command, and the new application is made a process group 
leader via the setpgidQ function. Other operating systems invoke applications using different 



In order to stop an application on the Unix platforms, if a signal is to be sent to the 
application, the killpgO function is used, or else if a script or command is to be executed to 
shutdown the application, the csh command is executed (via the systemO function) 
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specifying the full path and executable name of the command along with any arguments for 
the command. It should be noted that if the application default shutdown time elapses and 
the application has not died, the respective one of the Program Control Agents FG52A- 
FG52N advantageously sends a SIGKJLL signal to the application by calling killpgO. 

5 

As illustrated in FrgFIGS. +1A. II), the Program Control Agents (PCA-PCN) 
advantageously can be instantiated on stand-alone hosts A - N. In that case, the Program 
Control Agents PCA-PCN (FGi 2A-FGS2N in ftgFlGS. 22A, 2B) send heartbeat messages 
to Program Control FG50 approximately once per second to indicate that they are still tny*tip 
10 and miming." Moreover, every ten seconds, the Program Control Agents PCA-PCN (FG32A- 
FG52N) send complete configuration information on all running applications to Program 
Control FG50, It should be noted that the terminology employed in figFIGS. +1A, ID differs 
from that in FfgFIGS, 22 A, 2B to emphasize the distinction between software instantiated 
on a host and a function provided by the Resource Management Architecture. 

IS 

The Program Control function FG50 is the decision-making component of the 
Program Control functional group FG5 , It maintains complete informati on on everything thai 
is running across all platforms in the distributed environment. The Program Control function 
FG50 receives input data from PCA-PCN (FG52A-FG52N), the Program Control Displays 
10 FG54A-FG54N, the Resource Manager FG42, and the Host Discovery function FG14. 

It will be appreciated from the preceding discussion that the Program Control FGJO 
provides startup and shutdown orders to the Program Control Agents FG52A-FG52N based 
on operator or Resource Manager-initiated orders. If the Program Control Agents report that 
25 an application has terminated abnormally, the Program Control FG J 0 pro vi des a noti ftcation 
to the Resource Manager FG42, to the Program Control Display's FG54A - FG54N, and to 
any other component to which it is connected. When the Program Control function FGSO is 
first brought up, it can be configured to attempt to start Program Control agents on every host 
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the application startup will fail, and a "dependency failed" indication will be sent to the 
Display. It will be appreciated that this will cause the application status to be displayed in, 
for example, y ellow and post an alert to the Alert window on one of the Program Control 
Displays FG54A-FG54N. 

5 

Preferably, Program Control function FG50 also handles simple startup timing 
dependencies between applications and will reorder a list of applications that were selected 
to be started simultaneously if doing so will resolve startup order dependencies betw een the 
applications. Otherwise, the Program Control function FG50 sends a request to the Resource 
10 Manager to attempt to resolve the dependencies. 

The Program Control Display serves as the operator console for controlling the 
distributed environment. From the Display, shown inftgFIGS. 55 A. 5B, the Operator can: 
1 ) see the status and configuration of currently executing applications A 1 -N M ; 
15 2) see the status of Program Control Agents PCA-PCN on each host A-N; 

3) see and browse the application system structure defined in the System 
Specification Files FG32; 

4) load configuration files FGS6 

5) save configuration files FGS6 

20 6) edit the configuration of applications that are not currently running; 

7} create new application entries by dragging an application, application system, 
or application subsystem icon onto the application status area; 

8) manually start specific applications; 

9) manually stop specific applications; 

25 10) manually start all applications that have the "Stan All" flag set; 
] 1 ) manually slop all applications; 

1 2) turn host fault detection on or off(if on, lossof 3 consecutive heartbeats from 
a Program Control Agent will result in declaring the host down); and 
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defined in the System Specification Files. The Program Control function FG50 will also 
attempt to start a Program Control Agent on a newly discovered host (discovered via the 
Host Discovery function FG 1 4) if Host Discovery has been enabled on the Program Control 
Displays FG54A-FG54N. 

S 

The Proggram Control function FGSO also receives periodic heartbeat messages, e.g., 
once per second, from each of the Program Control Agents FG52A-FG52N, as discussed 
above. If Fault Detection has been enabled at the Program Control Displays FG54A-FG54N, 
if three consecutive heartbeat messages from en Agent, eg, FG52A, are missed, the host that 
to the agent is running on is declared down and all linked functions-, including the Resource 
Manager FG42 and the Displays FG54A-FG54N are notified. 

As mentioned above, the Proggram Control function FGSO sends out periodic 

I s are shutdown, or fail. These notifications are sent out to all linked functions 

It should be noted that the Proggram Control function FG50 uses the same message 
traffic and internal processing for handling application startup and shutdown orders received 
from either the Resource Manager FG42 or from the Program Control Displays FG54A- 

20 FG54N. How ever, if a startup order received from one of the Program Control Displays 
FG54A-FG54N indicates that the Resource Manager FG42 should determine where to run 
the application, a request to allocate the application is sent to the Resource Manager FG42. 
When no response is received from the Resource Manager FG42 within a predetermined 
timeout period, the Proggram Control function FG50 will automatically start the application 

2) on the default host. Moreover, when an application startup cannot proceed due to an 
unfulfilled application startup dependency, a request will be made to the Resource Manager 
FG42 to attempt to resolve the dependency. If the Resource Manager FG42 either cannot 
resolve the dependency or no response is received within a predetermined timeout period, 
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1 3) turn host discovery on or off (if on, a new host message from the Host 
Discovery component will result in attempting to sun up a Program Control 
Agent on the new host). 

S It will be appreciated fromfigFlGS. 52 A, 2B that multiple Program Control Displays 
FG54 A-FG54N advantageously can be run simultaneously. If this is done, any configuration 
change actions will be reflected on all the displays. Whenever application stop or start 
actions are taken by the display operator, a message is sent to the Proggram Control function 
FG50 which is responsible for enacting the start or stop action. The Program Control 

to function FGJO also sends indications of any status changes to the Program Control Displays 
FG54A-FG54N as soon as the status changes are seen. In addition, periodic status updates 
are also sent to the Program Control Displays FG54 A -FG54 MN . 

The Program Control Configuration Files are text files that are read in by the Program 
15 Control Display when the operator wishes to load a new application configuration. A 
Configuration File is an ASCII file containing a list of applications. The format of an entry 
in a Configuration File is shown in Table I below. 

Table 1 

20 Application TACFIREitHflR 

HmI ckctnl 

Dbpbj umbridl:M 

Auto Start 0 

RM Stirl 0 
25 C«^ok 1 

Time Ddqr t 

StutnpDIr "SLNV SIM VERSION/TACFTREpr»cr»»or" 
S*utapEu -SENV"siM~VERSIONrTACFIREpr«uoirtMfli»" 
StutapArp "-dlip.rl "SDIS PORT.NUM -cfflint W(HOSTNAME, 
30 AAWsTaetletl SfanKCFF.Bnkcr)* 
ShBtdownEit S1CINT 
UfTypc STDOUT 
LagDtr "/rarrtmp" 



The Configuration file advantageously can include the following fields: 

1 ) The Application field, which identifies the full application name as defined 
in the System Spec. Files FG32 (i.e., System: Subsystem: Application). 

2) The Host field, which is the desired or default host that this application 
should be started on. 

3) The Display field, which is an optional field used when graphical display 
output from an application needs to be rerouted to a display on a different 
host. 

4) The Auto start flag, which identifies whether the application is to be started 
automatically if the "Start All" action is selected by the operator from the 
Program Control Display, (If the (lag were set to "1", then the application 
would be started. If the flag were set to "0," it would not be started.) 

5) The RMStart flag, which identifies whether the the-Resourcc Manager 
should be queried at run-time to determine what host the application should 
be started on. The valid values are "0" for "NO" and "1 " for "YES". 

6) The Console flag, which identifies whether the application needs to be started 
in an Xtcrm window. The valid values are 0 for "NO" and 1 for "YES". 

7) The Time EMay field, which identifies how many seconds to wait after the 
previous application has been started before starting this application. 

8) The StarrupDir field, which identifies the current working directory that is 
to be set prior to starting up the application. This directory is usually the same 
as the directory where the executable for the application resides but does not 
have to be. As this example shows, environment variables may be used in the 
path. 

9) The Startup E« field identifies the entire path and name of ihe application 
executable. 

10) The Startup A rgj field, which contains all the argument values needed for 
this particular applicati on. As this example indicates, the argument values can 



including host and network statuses and performance, application system statuses and 
performance, as well as the status and performance of the other Resource Management 
architecture functions. Most of the displays use OpcnGL and Motif, the latter being built 
with ICS's Builder Xcessory toolkit, and run on Silicon Graphics (SGI) platforms in an 
exemplary case. Several of the displays can also run on the Sun Solaris platforms. The 
displays that make up the display functional group FG6 include: 

1) Host Displays FG62A -FG62N. Show layout of hosts along with host status, 
network connectivity, and process statuses. 

2) Path Display FG*4. Shows the status of applications in key end-to-end data 
flow paths along with performance and load graphs. 

3) Resource Management Decision Review Display FG6S. Shows a summary 
of allocation decisions made by ihe Resource Management system along with 
tuning information and host fitness scores. 

4) Graph Tool Instrumentation Displays FG69A-FG69N. Provides a user- 
configurable set of display widgets used for run-time monitoring of 
instrumented status and performance information. 

5) System Readiness Display FG66. Shows the status of each hardware and 
software system, subsystem, and application defined in the System 
Specification Files and allow the operator to interactively change system and 
subsystem priorities. 

figFlGS. frisA, 6B represent a screen capture of an exemplary one of the Host 
Displays FG62A-FG62N, which provide graphical representations of various sets of the hosts 
A- N in the distributed environment. The Host Displays show the status of each host, host 
network connectivity, and the status of interesting processes running on the hosts. The Host 
Display operator can also select hosts shown on the Host Display and bring up real-time 
graphs of system performance for the selected hosts including CPU utilization, memory 
utilization, network packets in, network packets out, and paging activity . A screen capture 

-51- 



NCN-83017 

be dynamically set at run time if needed Environment variables may also be 
used within the argument list. In this example, the %(UNIQUE, ], 40, lsis) 
argument would yield a number from 1 to 40 which is unique within a 
context named "lsis". Another resolution of %(UNIQUE, 1, 40, lsis) would 
yield a different number. 

11) The ShutdownExe field, which identifies which signal defined within the 
application that program control is to use to shutdown this application. Some 
examples would be SIGINT, SIGTERM, or SIGKILL. Ashutdown script can 
also be used to shutdown the application. (In that case, there would be 
ShutdownDir, Shut d own F.ie, and ShutdownArgs fields listed. The usage 
for the shutdown fields would be used exactly the same as the startup fields.) 

12) The LogType field, which identifies which outputs are to be written to the 
specified log file. The valid values are STDOUT, STDERR, and LOG_ALL. 
STDOUT is the normal output of the application (stdout). STDERR is the 
error output of the application (stderr). LOG_ALL writes both stdout and 
stderr outputs to the file. 

1 3) The Log Dir indicates the directory where the log file will be written. Again, 
environment variables may be used here. The log file name will be 
*<userid>_<appname>_<pid>.log* where <appname> is the full application 
name as specified in the Application field, <userid> is the userid of the 
current user under which the program control application is running, and 
<pid> is the system assigned process id of the application being executed. 

FG4 - DISPLAY FUNCTIONAL GROUP 

A number of displays which show system configuration data and instrumentation data 
in near real-time are included as part of the Resource Management Architecture. These 
displays support operator and user monitoring of the operation of the distri buted environment 
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of host specific performance information is provided in FigFJGS. 77 A, 7B. 

FigFIGS. 8isA, RB represctH a screen capture of a representative Path Display FG64, 
generated by the Resource Management architecture, which shows the status of key system 
data flow paths consisting of multiple application stages. The number of copies of each 
application in the path is shown labeled with the host on which the application is running 
In addition, it should be mentioned that as many as three real-time graphs can be produced 
to depict run-time performance and load metrics related to the applications in the selected 
datapath. 



BgFIGS. 9isA, >)H represent a screen capture of the Resource Management Di 
Review Display FG68, which advantageously can provide a summary of allocation and 
reallocation actions taken by the Resource Manager FG42, For each action, timing 
information regarding how long it took the Resource Management functions, e.g., the 
Resource Manager FG42 and the Program Controller FG50, to both arrive at a decision and 
to enact the decided action are shown along with host fitness scores thai were used in 
arriving at ut 



FissFIGS. -reiOA, 10B and -HI 1 A. 1 IB are screen captures of the Graph Tool 
Instrumentation Displays FG69A-FG69N, which depict user-configurable displays capable 
of receiveing data via standardized message formats and open interfaces. The Graph Tool 
Displays FG69A-FG69N allow the operator to select and configure various display widgets 
(line graphs, bar charts, pie charts, meters, and text boxes) to build a desired display layout 
Data sources for driving the widgets can also be selected interactively. 

FtgKlGS. 12-wA, 12B represent a screen capture of the System Readiness Display 
FG66, wfcich advantageously can be a Java™ display with a CORBA™ interface. The 
display FG66 shows the status of each hardware system, host, application system, application 
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subsystem, and application defined in the System Specification Files. The lop portion of the 
display shows a summary status for each defined application system. It should be noted that 
the display operator can also change system and subsystem priorities and send the changed 
priorities to the Resource Manager function FG42. 

As mentioned above, the RMComms middleware package provides object-oriented 
client-server services for message communication between distributed applications and 
function modules. The middleware provides location transparency and automatic socket 
connections and reconnections between client and server applications. These sen ices 
advantageously can be accessed through an object-oriented API which allows client and 
server objects to be easily created and exchange user-defined message data The abstraction 
provided by the API allows the user to quickly and easily create distributed applications 
without needing to be aware of the details of the underlying network mechanisms The 
RMComms middleware provides the following functions: 

provides location transparency between clients and servers 
provides a simple powerful object-oriented client-server API 
supports reliable transport of user-defined message data 
based on Berkeley sockets 

uses TCP for message transport 

uses UDP multicast for identification of new clients or servers 
servers identified by unique assigned UDP/TCP port numbers 
provides general purpose callback function registration capabilities 

user-specified message callback functions invoked when specified 
messages arrive 

user-speci fied connection status callback function invoked when new 
client-server connections are established or existing connections are 
broken 
support for multi-threading 



Solaris*S6 2.7 
C++ language support using native and GNU compilers 

The RMComms middleware is implemented as a shareable object-oriented C++ 
library. The library provides four primary object classes, which are detailed in Attached 
Appendix C. It will be appreciated that the applications link with this library and can then 
instantiate client and server objects for communicating with other local or remote 
applications. It should be mentioned that the application source code must also include a set 
of header files that allow connections between client and server objects, where each server 



type is assigned a server port number. For clients and serv ers that wi 
the client and the serv er objects are created specifying the same server port number. Multiple 
servers of the same type can also be created, which all use the same server port number. This 
advantageously provides the ability for many-to-many client-server connections to be 
established, as illustrated in FtglG. 4. Control of which servers the clients actually connect 
to is handled on the client side; clients can specify whether the)- wish to establish connections 
with all servers in the distributed environment, with a particular set of servers, or with all 
servers running on a particular set of hosts 

The operation of the Resource Management Architecture will now be described while 
referring to Figs. 13A-13C, wtiich illustrate various operations in the distributed 
environment. More specifically, the Resource Management Architecture of the system 
illustrated in Figs. 13A includes hosts A-N, where host A provides a video source server 
application A- 1 , host B provides a video distribution application B- 1 , a contract application 
B-2, and a host load monitor B-3, and host C provides a display broker application C-l 
applying video signals to a display driver C-2. It will be appreciated that host D is idle and 
mat the connections between the various hosts constitute the network 1 00'. In addition, the 
Resource Management Architecture of FiglG. 13A instantiates various functions, e.g., an 
instrumentation broker FG26\ a QoS manager FG44', a resource manager Fg<i42' and a 
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supports both polled and asynchronous I/O 
thread-safe 

provides automatic connections between clients and servers 

supports multiple client and server connections within the same 
application 

provides automatic connections to new clients / new servers 
supports simultaneous many-to-many client-server connections 
no separate "naming service" or "application registration" components 
provides automatic client-server connection fault detection and recovery 
provides fault detection mechanisms based on timeouts and broken 



supports fault recovery v ia automatic reconnections between clients 
and servers 

provides basic support for data marshalling between machine architectures 
byie-swappirtg 

explicit message data type specification 

all message data sent out using network byte order 

provides basic capabilities for reading the system clock and performing time 

conversions 

allows registration of user-defined signal (interrupt) handler functions 
layered object-oriented design and impten 
cross-platform support: 

SGI Iri-clRIX 6.3/6 4/6.5 
Sun Solaris 2.S.1/2.6/2.7/.2.8 
HP HP-UX 10.20 
Linux 2.1/2.2 
Windows NT 4.0 
Windows 95/98/2000 
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program control FG50 1 . The instrumentation broker FG26' receives data from each of the 
applications running in the distributed environment, although only the lines of 
communication between the applications running on host B are actually depicted. From the 
discussion above, it will be appreciated that each of the applications is linked to an 
Instrumentation API. 

Referring now to FtglG. 13B, a QoS violation and its consequences is depicted. In 
particular, the Instrumentation broker FG26' provides data to the QoS manager FG44' which 
is indicative of a QoS violation. The QoS manager FG44' notifies the resource manager 
F&G42' of the violation; the resource manager determines that duplicate copies of the 
applications running on host B are required and that these copies should be placed on host 
D. The resource manager FG42' transmits instructions to the Program Control function 
FgG50', which starts copies of the running applications, i.e., a video distribution application 
D-l, a contract application D-2, and a host load monitor D-3, on host D. FtglG. 13C 
illustrates shutdown of the application copies running on host B. It will be appreciated that 
this shutdown may be initiated responsive to the original QoS violation, another QoS 
violation, or a query from the user, 

Having discussed the various functions and features of the Resource Management 
Architecture in gross, selected functions and features will now be described in detail. It will 
be appreciated that the discussion of the various functions will be signaled using the 
designations established with respect to Fig FIGS. 22A, 2B. 

FG42 - Resource Manager Function 

As mentioned above, the Resource Manager FG42 is the primary decision-making 
component of the Resource Management functional group. It is responsible for 

(I) responding to application and host failures by determining if and what 



recovery actions should be taken; 

determining if and where to place new copies of scalable applications or 
which scalable applications should be shutdown when the QoS Managers 
indicate that scale-up or scale-down actions should be taken based on 
measured application performance: 

determining where new applications should be placed when requested to do 
so by Program Control: and 

determining which and how many applications should run based on 
application system (mission) priorities. 
In order to accomplish these tasks, the Resource Manager FG42 maintains a global view of 
the state of the entire distributed environment including status information on all hosts, 
networks, and applications In addition, the Resource Manager FG42 also calculates software 
and hardware readiness metrics and reports these readiness values for display purposes. 



0) 



(4) 



The Resource Manager FG42 is an obj ect -oriented multi-threaded ap 



in C++, which uses the RMComms middleware for all external communication. The 
Resource Manager FG42 communicates with the various software components instantiating 
the (1) Program Control FG50, 2) Hardware Broker FG40, 3) QoS Managers FG44A - 
FG44N, 4) QoS Specification Control FG29, 5) Readiness Broker in Readiness Display 
F066, 6) Globus Broker (not shown), and 7) RM Decision Review Displays FG68A- 
FG68N. 

It will be appreciated that ihe Resource Manager FG42 receives status and failure 
information about hosts and networks from the Host and Network Monitoring functional 
group FG1, and applications from the Program Control functional group FG5. This 
information includes periodic status updates as well as immediate updates when statuses 
change, e.g., when a new host is detected or an application fails. In the case of any 
application shutdown, information as to whether the applications were intentionally 
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the "best" hosts for placing new applications when: 

( 1 ) responding to requests from the QoS Managers to scale up additional copies 
of an application; 

(2) attempting to restart failed applications, 

(3) responding to requests to dj-namicaUy allocate certain applications; and 

(4) responding to application system (mission) priority changes which require 
scaling up additional applications. 

Advantageously, the Resource Manager FG42 also receives requests from the QoS 
Managers FG44A - FG44N for scaling up, moving, or scaling down specific applications. 
The Resource Manager FG42 responds to these requests by determining whether Ihe request 
should be acted upon and, if so, determines the specific action to take and issues orders to 
the Program Control function FG50 to start up or shutdown specific applications on specific 
hosts. The QoS Managers FG44A - FG44N are responsible for monitoring specific system 
performance metrics (e.g., quality of service, or QoS, requirements ) via instrumentation and 
detennining if performance can be improved by scaling up or moving certain applications. 
When this occurs, the QoS Managers send a request to the Resource Manager FG42 
indicating that a new copy of a specific application should be started. If the QoS Managers 
determine that the performance of a scalable application can be improved by moving an 
application, a scale up request is fust sent to the Resource Manager FG42 and when Ihe new 
application has been started, a seal edowTi request is then sent to the Resource Manager FG42. 
Moreover, when the QoS Managers FG44A -FG44N determine thai there are more copies 
of scalable application running then are needed, requests to shutdown specific applications 
are sent to the Resource Manager FG42 

It will be appreciated that the Resource Management Architecture distributes 
functionality between the QoS Managers FG44A-FG44N and the Resource Manager FG42. 
Thus, the QoS Managers determine what actions would potentially improve performance. 



shutdown or whether the application actually failed advantageously can be provided. -The 
Program Control function FG50 also issues requests to the Resource Manager FG42 
whenever new applications need to be dynamically allocated and whenever the Program 
Control function FG50 determines that the Resource Manager FG42 needs to assess and 
attempt to resolve inter-application dependencies (e.g., one application which needs to be 
running prior to starting up another application). - 

The Resource Manager FG42 responds to applications faults and host failures by 
deterrnining whether the failed appli cations can and should be restarted and attempting to 
determine where (and if) there are hosts available that the application can run on. When a 
decision is made by the Resource Manager FG42, a message is sent to Program Control 
function FG50 specifying what application to start and where to put it. The same general 
mechanism is used when the Program Control function requests that the Resource Manager 
FG42 determine where to start new applications and/or how to resolve inter-application 
dependencies; the Resource Manager FG42 responds with orders indicating what 
applications to start and where to start them. The Resource Manager FG42 advantageously 
can send application shutdown orders to the Program Control function FG50 requesting that 
a certain running application be stopped ; this can occur when ihe QoS Managers indicate that 
certain scalable applications have too many copies running or when application system 
priority changes (to lower priorities) occur resulting in scaling back the application system 
configuration. See Figs. I3B and 1 3C and the associated discussion above. 

The Resource Manager FG42 receives host load and host fitness information from 
the Hardware Broker (Host Load Analyzer) function FG40. This information includes overall 
host fitness scores, CPU-based fitness scores, network-based fitness scores, and memory and 
paguig-based fitness scores along with the SPEC95 rating of the hosts. This information is 
received approximately once a second and includes information on all known hosts in the 
distributed system. These scores are used by the Resource Manager FG42 for determining 



while the Resource Manager FG42 has final authority to determine whether to implement Ihe 
requested actions. 

It should be noted that when the Resource Manager FG42 is first started, it reads in 
the System Specification Files FG32 {via calls to the System Specification Library (SSL) 
FgC34) which contains the list of hosts that are known to be (operating) in the distributed 
environment and information on all applications that can be run in the distributed 
environment. The application-level information includes where specific applications can be 
run, which applications are scalable, which applications can be restarted, and any 
dependencies between applications - In addition, the Resource Manager FG42 receives 
updated application survivability specifications from the QoS Specification Control function. 
This information overrides the application survivability information that was initially loaded 
in from the System Specification Files FG32 for the specified application. The information 
is used by the Resource Manager FG42 to determine whether the specific application will be 
restarted if it fails at run- time. 

It should also be noted that the Resource Manager FG42 sends application system and 
hardware system readiness and system (mission) priority information to the Readiness 
Broker, which is a translator withing the Readiness Display FG66 and to the Globus Broker 
(another Broker (not shown)). The Readiness Broker is responsible for driving a GUI/display 
FG66, which shows the current readiness data and allows the system (mission) priorities to 
be changed and sent back to the Resource Manager FG42. The Globus Broker provides 
basically the same functionality except that only a high-level subset of the readiness data 
provided to the Readiness Broker is provided to the Globus Broker. The readiness 
information sent to the Readiness Broker consists of readiness values for each application, 
application subsystem, and application system defined in the System Specification Files 
FG32. -The scores advantageously can be based on the status (up/down) of the applications 
and the percentage of potential copies of scalable applications that are currently running. 
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Host and network readiness scores are determined based on the host loads and host fitness 
scores received from the Hardware Broker FG40- 

The Resource Manager FG42 also sends information about allocation and 
reallocation decisions to the RM Decision Review Display FG68 (FigFIGS. <B>A. *>B) 
Information on the decision that was made, what event the decision was in response to, and 
how long it took to both make the decision and implement the decision are sent to the 


• 
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The exemplary instance of the Hardware Broker FG40 is an object-oriented multi- 
threaded application. At the highest lev el, the Hardware Broker object contains the elements 
listed in Table 11 below. It will be noted that Table II contains a brief description of each of 
these objects. Additional details are provided in CD-Appendix E 

5 




display. In addition, information about the top choices for where an application could have 




No 


Title 


Description 
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potentially been placed is also sent (if applicable); this information includes the host fitness 
scores for the selected host and other hosts which could have been selected. 

As described above, the Resource Manager function FG42 communicates with 
Program Control FG50, the Hardware Broker FG40, the QoS Managers FG44A -FG44N, 
QoS Specification Control (not shown - legacy function), the Readiness Broker of the 
Readiness Display FG66, the Globus Broker (not shown), and the RM Decision Review 
Display FG68 using the RMComms middleware. The message formats and contents of each 
message that is exchanged between the Resource Manager function FG42 and Other 
functional elements of the Resource Management architecture are described in CD-Appendix 
D. The tuning and/or event trigger for each message is also described. 
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Host Fitness Database 
object (FitnessDB 


The Host Fitness Database object stores load history 
data and fitness score information for each host. The 
Host Fitness Database is updated and fitness scores are 
recalculated when new History Server Hosl Status 
Response Messages are received For each host, a 
circular queue of host load history data (Hostlnstance 
class) is maintained with the newest data being placed 
at the end of the queue; this history data is used for 
recalculating host fitness scores. The Host Fitness 
Database also contains a System Specification Library 
(SSL) object which is used to access SPEC rating 
information for the hosts. 






FG40 • Host Load Analyzer (Hardware Broker) Function 

The Hardware Broker FG40 provides the host load analysis function of the Resource 
Management functional group FG4. It is responsible primarily for determining the host and 
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Signal Registration 
object (Signal Registry 
class) 


denned S1GINT signal handler to be registered in order 
to permit the Hardware Broker FG4ttoFG40 to be 
shutdown gracefully. 




25 


network loads on each host within the distributed computing environment The Hardware 
Broker FG40 assigns a set of fitness scores for each host and periodically provides the list 
of fitness scores to the Resource Manager FG42. -FigrKlG, 1 4 illustrates the connectivity and 
high-level data flow between the Hard ware Broker and the other Resource Management and 
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Resource Management-related components. 

The Hardware Broker FG40 is an object-oriented multi-threaded application written 
in C++, which uses the RMComms middleware for all external communication. It receives 
operating system-level statuses and statistics for each host from the History 5erver(s) FG 1 2A 
-FG 1 2N. This information is used for calculating CPU, network, memory, paging activity. 
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Network Subnet 
Information Database 
object (SubnetDB 
class) 


The Network Subnet Information Database object is 
used to store IP address, maximum bandwidth, and 
MTU size for each network specified in the 
networla dat file. This information is used for 
converting network packet load information to 
bytes/second network load information. 
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and overall fitness scores for each host The Hardware Broker periodically (once per second) 
sends the list of host fitness scores to the Resource Manager FG42. 

When the Hardware Broker FG40 is first started, it reads in the System Specification 
Files FG32 (via calls to System Specification Library (SSL) FG34) which contain the list of 
hosts that are known to be in the distributed environment. The Hardware Broker also reads 
in the file nerworksdat which contains a list of information about the bandwidth and 

used for converting host network load information based on packet counts to load 
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Remos Host Network 
Bandwidth Database 
object (RemosDB 
class) 


The Remos Host Network Bandwidth Database object 
stores the latest Remos-reported network bandwidth 
information for each host being monitored. The 
information stored consists of available bandwidth as 
well as maximum potential bandwidth on a specific 
host network link. If Remos bandwidth iriformation is 
available for a host and the latest data is less than 5 
seconds old, the Remos data will be used for 
calculating the network fitness score for the host. 




20 


information based on bytes per second and percentage of available bandwidth. 

It should be mentioned that there are two other RMComms interfaces that the 
Hardware Broker FG40 uses. Periodically (approximately every three seconds), the Hardware 
Broker FG40 sends a list of overall and network host fitness scores to the Hardware Broker 
instrumentation Display FG69A - FG69N. As mentioned above, these displays were 
constructed using the Graph Tool described in the Instrumentation Graph Tool Display. 
Additionally, the Hardware Broker FG40 can receive host-based network load data from the 
Remos Broker FG16, which receives network data via the Remos Network Monitoring 
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History Serv er 
Interface object 
(HistSen Interface 
class) 


The History Server Interface object inherits from the 
RMComms TCPCommClient class and is responsible 
for maintaining connections to the History Servers), 
for registering status and message handler callback 
functions, for sending messages to the History 
Servers), and for invoking the status and message 
handler callback functions when connections to 
History Sen ers are either established or broken or new 
messages are received from a History Server. 
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software (denoted 2 in FrgFIGS. 22A. 2B). If Remos network data is available Tor any of the 
hosts that are being monitored, the Remos data is used for the network fitness score 
calculation for that host rather than the hosl network data received from the History 
Serverfs). 
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Instrumentation Graph 
Tool Display Interface 
object ( Ins ti Interface 
class) 



Resource Manager 
Interface object 
(ResMgrinterface 
class) 



The Instrumentation Graph Tool Display Interface 
object inherits from the RMComms TCPCommServer 
class and is responsible for maintaining connections to 
the Graph Tool Display(s), for registering status and 
message handler callback functions, for sending 
messages to the Graph Tool Displays), and for 
invoking the status and message handler callback 
functions when connections to Graph Tool Displays 
are either established or broken or new messages are 
received from a Graph Tool Display', 



The Resource Manager Interface object inherit; from 
the RMComms TCPCommServer class and is 
responsible for maintaining connections to the 
Resource Manager for registering status and message 
handler callback functions, for sending messages to the 
Resource Manager, and for invoking the status and 



the Resource Manager are either established or broken 
or new messages are received from the Resource 
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noted that the application can be scaled for both redundancy and/or load-sharing. In an 
exemplary case, each copy of the QoS Manager monitors all of the requirements associated 
with a single application path defined in the System Specification Files FG32. It will be 
appreciated mat the specific path to be monitored can be sped (led via command-Line 
parameters. By default, without specifying a path via the command-line, the QoS Manager 
Mill monitor all requirements for all defined paths. 

As mentioned above, the QoS Manager advantageously uses a sliding window 
algorithm to determine when to declare thai applications should be scaled up or scaled down. 
The inputs to the algorithm define both high and low sampling window sizes, the maximum 
number of allowed violations within the sampling window, and violation thresholds as a 
percentage of the actual specified requirement value. It will be appreciated that the sliding 
window algorithm was selected in an effort to damp out unexpected "noise" or "spikes" in 
the measured performance data. Use of threshold values states as a percentage of the actual 
requirement value was selected in order to scale up, or scale down, prior to violating the 
specified hard requirement. It will be understood that the success of this approach is highly 
dependent on the rate of change and noisiness of the measured data.. 



Again, the QoS Manager uses the RMComms middleware for all external 
communication, Each copy of the Resource Manager talks to ( 1 ) Resource Manager FG42, 
(2) Program Control FG50, (3) QoS Specification Control {not shown), (4) QoS Monitor 
FG29, (3) Instrumentation Correlators FG26A -FG26N, (6) Graph Too! Instrumentation 
Displays FG69A-FG69N, and (7) History Servers FG1 2A-FG12N. fin an exemplary case, 
the QoS Managers FG44A - FG44N advantageously can receive configuration orders from 
the Resource Manager FG42, which allows the Resource Manager FG42 to configure each 
QoS Manager to monitor specific application paths and also set the sliding window criteria 
to be used by each respective QoS Manager. 
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Remos Broker 


The Remos Broker Interface object inherits from the 




Interface object 


RMComms TCPCommClient class and is responsible 




(Remoslnterface class) 


for maintaining connect! 


ons to the Remos Broker for 






registering status and m< 


ssage handler callback 






functions, for sending m 


essages to the Remos Broker, 






and for invoking the Stat 


us and message handler 






callback functions when connections the Remos 






Broker are either establL 


Jied or broken or new 






messages are received from the Remos Broker. 



FC44: Quality-of-Service (QoS) Manager Function 

The QoS Managers FG44A - FG44N are responsible for monitoring application-level 
performance requirements, which requirements are defined in the System Specification Files 
FG32 and are monitored primarily via instrumentation data obtained directly from the 
application code. The QoS Managers FG44A - FG44N advantageously determine if 
applications or application paths are satisfying their assigned requirements. When an 
application is not meeting its performance requirements and the application is scalable (in 
the sense that multiple copies can be run and the copies will perform load-sharing across the 
copies), the QoS Managers FG44A - FG44N will either request that the Resource Manager 
FG42 scale up a new copy of the application or move the application to a new host (which 
hopefully will result in better performance). Moreover, if there are multiple copies of a 
scalable application running, and all copies are performing below the specified requirement 
threshold, the QoS Managers FG44A • FG44N will request that the Resource Manager 
shutdown a specific copy. 

The QoS Manager is a single-threaded application written in OC++. It should be 
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Each copy of the QoS Manager ad vantageousfy can transmit application scale up and 
scale down requests to the Resource Manager FG42 when the measured performance data 
for a respective application violates either the high (scale up) or low (scale down) sliding 
window criteria for a specific requirement. A scale up request indicates which application 
on which host has violated the performance criteria, and a scale down request indicates 
which application on which host is recommended to be shutdown. Each copy of the QoS 
Manager can also request that the Resource Manager move an application. This will occur 
in the case where one copy of an application is performing much worse than all other running 
copies The move request is implemented as a scale up request followed by a scale down 
request (of the badly performing copy); the scale down request is not transmitted to the 
Resource Manager FG42 until the scale up action has been implemented. 

The QoS Managers FG44A - FG44N use the application "settling times" defined in 
the System Specification Files to ensure that once a requested action has been sent to the 
Resource Manager that no additional actions are requested until after the application settling 
time has elapsed. This provides time for initialization and configuration among the 
application copies to occur. In future releases, the inter-application dependencies will be used 
instead. 

The division of responsibility between the QoS Managers FG44A - FG44N and the 
Resource Manager FG42 is as follows: 

(1) the QoS Managers FG44A - FG44N determine what actions would 
potentially improve performance; and 

(2) the Resource Manager FG42hwFC42 has final authority to determine 
whether to implement the requested actions 

ll should be mentioned that there is a Request Acknowledge message from the 
Resource Manager FG42 which has been defined and implemented within the QoS Manager 
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code. This message is intended to provide feedback to the QoS Manager indicating thai the 




It should also be mentioned that the Resource Manager FG42 receives updated 




request had been successfully received and whether the Resource Manager FG42 intends to 




application survivability specifications from the QoS Specification Control component. This 




implement the request. 




information overrides the application survivability information that was initially loaded in 
from the System Specification Files for the specified application. The information is used by 
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As previously mentioned, the QoS Managers FG44A - FG44N receive application 


5 


the Resource Manager FG42 to determine whether the specific application will be restarted 




status and state information from the Program Control function FG50 Program Control 




if it fails at run-time. 




periodically sends application status updates for all running applications and also sends 








immediate indications of any applications which have been started or stopped. This 




As described above, the QoS Managers FG44A - FG44N communicates with the 




information is used by the QoS Managers FG44A-FG44N, along with the instrumented 




Resource Manager FG42, Program Control FG50, the QoS Specification Control (not 
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performance data being received via the QoS Monitor FG29 and Instrumentation Correlators 
FG26A-FG26N, to determine the exact state of the monitored applications Al -NM that are 
running This information is also used to determine when (and if) requested actions have 
been implemented by the Resource Manager FG42. The information is also used for setting 
up and discarding internal data structures used for monitoring the performance of each 
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shown), the QoS Monitor FG29, an Instrumentation Correlator (generally denoted FG24), 
a Graph Tool Instrumentation Display (generally denoted FG69), and the History Servers 
FG12A-FGI2N using the RMComms middleware. The message formats and contents of 
each message that is exchanged between the QoS Managers FG44A - FG44N and these other 
functional components are described in greater detail in CD-Appendix F. Additional details 
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application. 

The QoS Managers FG44A - FG44N also receive application-level instrumentation 
data indicating current application performance values from the Instrumentation Correlators 
FG24A-FG24N, the Instrumentation Brokers FG26A-FG26N, and/or the Jewel 


15 


regarding the timing and/or event trigger for each message is also described in the Appendix. 

FG3: SYSTEM SPECIFICATION LANGUAGE & SYSTEM SPECIFICATION 
LIBRARY (SSL) FUNCTIONS 
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Instrumentation Broker (QoS Monitor) FG29. The instrumentation data that is received 
contains (at a minimum): 

39: (l> the timetag regarding when the data was generated; 
4ft (2) the hostname and IP address of the host where the application that the data 
is associated with is running; 


20 


In order to effectively manage a pool of computing resources, the Resource Manager 
FG42 requires some means or mechanism of determining the capabilities and configuration 
of the computing resources under its control, as w ell as the software components that need 
to be executed and the dependencies of these software components on both hardware and 
software resources. Additionally, the Resource Manager FG42 requires the capability to 


li 


■Ht (3) the process id (pid) of the application thai the data is associated with; and 

(4i — j the ev ent number of the instrumentation message. 
The event number of the instrumentation message specifies the type of instrumentation data 
that has been received and the hostname, IP address, and pid are used, in conjunction with 
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determine the expected mission-level and application-level requirements Furthermore, the 
Resource Manager FG42 must be able to determine what control capabilities are available 
to be used to attempt to recover from fault or QoS violation conditions 
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the application data recei ved from Program Control, to determine the specific application that 




In order to address these needs, a System and Software Specification Grammar has 




the data is associated with. 




been developed to capture the "static" information needed by the Resource Manager FG42 
for effecti vety managing a poo 1 of distributed resources. The grammar captures the following 




If the contents of the instrumentation message match any of the application 




information: 


5 


performance requirements that are currently being monitored by the QoS Manager, the data 


5 






value is added to the proper requirement sliding window for the specified application. The 




• Hardware and Operating Systems 




sliding window algorithm is then checked to determine if the new sample triggered a 




• Hardware Configuration 




violation of either the high or low sliding window. If a high threshold sliding window 




• Network Configuration 




violation occurs and the application does not already have the maximum number of copies 




• Operating System and Version 
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running, a determination is made as to whether performance can be best improved by starting 
a new application (scale up) or by moving an existing copy to a different host The 
corresponding action recommendation will then be sent to the Resource Manager. In an 
exemplary case, the criteria for determining w hether an application should be moved rather 
than scaled up is based on relative performance of the replicated applications. Thus, if one 
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•Software 

• Systems, Subsystems, Applications, Processes 

• Resource Requirements 

• QoS Requirements (Events) 

• Survivability Requirements 
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application is performing much worse [> 50%] than the other copies, the recommendation 
will be to move the application. Likewise, if the new sample triggers a low threshold sliding 
window violation, and ihe application has more than the minimum number of copies running, 
a recommendation will be sent to the Resource Manager FG42 requesting that the copy of 
the application that is experiencing the worst performance be scaled down. 


li 


• Path Information; Structure and QoS Requirements 

As part of the grammar development effort, a specification library has also been 
developed that parses the specification files and provides an API for accessing the 
specification information, li will be noted that the specification library wbs written in C++ 
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It will be appreciated from the discussion above that when a copy of the QoS 
Manager is first started, it reads in the System Specification Files FG32 (via calls to System 
Specification Library (SSL) FG34), which contain the list of hosts that are known to be in 
the distributed environment and information on all applications that can be run in the 


20 


and has been ported for all development platforms including Solaris 2.6, Solaris 2.7, Irtdr* 
6.5, HP-UX 10,20, Red Hat Linux 6.0, and Windows NT 4.0. The library advantageously can 
be used by substantially all of the Resource Management functional elements, including 
Program Control FG50, Resource Manager FG42, Path QoS Managers, Hardware Broker 
FG40, and History Servers FG 1 2A-FGI 2N. 
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distributed environment. The application-level information includes where specific 
applications can be run, which applications are scalable, which applications can be restarted, 
and any dependencies between applications. 
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As illustrated in FrglG. 3, the API library consists of ayacca file FG302 that defines 
the BNF grammar, a lex file FG304 that defines the tokens of the language, and a set of C++ 
classes FG306 thai Store the Spec file information. The lex file FG304 is compiled with the 

-72- 



GNU tool flex FG3 1 0 and it creates a C++ source file FG320. The GNU tool bison FG312 
compiles the yacca file FG302 and creates C++ source and header files FG322 and FG324. 
It will benoted thai the lex source file FG304 includes the yacca header file FG322. The C++ 
compiler FG314 then compiles these two source files to create lex and yacca objects FG330 
and FG332. The C++ compiler FG314 also compiles the C++ storage classes FG334. All of 
these objects are linked into a single library FG34 to be utilized by on application. FiglG, 3 
illustrates this process flow. 

The Software Specifications Grammar (S-S Or) provides techniques for describing the 
characteristics and requirements of dynamic, path-based real-time systems as well as 
providing abstractions to describe the properties of the software, such as hierarchical 
structure, inter-connectivity relationships, and run-time execution constraints. The S-S G- also 
allows description of the physical structure or composition of the hardware such as LANs, 
hosts, interconnecting devices or lC&s (such as bridges, hubs, and routers), and their 
statically known properties (e.g., peak capacities). Furthermore, the Quality-of-Service(QoS) 
requirements on various system components advantageously can be described. 

At the highest level, a specification consists of a collection of software systems, 
hardware systems, and network systems. The language rules for specifying systems arc 
described generally below and in detail in CD- Appendix G. The system specification 
language hierarchy is shown below; selected details will be presented immediately following. 

• Software Specifications 
• Application 

•Security 

* Configuration 

• Hardware Requirements 

• Startup Info 
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In contrast, an application is an executable program that can be started as an 
autonomous process on a host. Application attributes include all information necessary to 
startup and shutdown the application. Associated startup block and the shutdown blocks 
describe how to start and stop the application and includes information such as the directory 
and name of the application, command line options, and environment variable settings. - 

An application instantiates an SSL object by calling its constructor. This parses the 
spec files in the specified directory and populates the object hierarchy to provide the data to 
the application. The SSL class contains an SSL_Container member, that holds the spec file 
data in its lists and maps. All the systems from the spec files are contained in the appropriate 
list, software systems in the s wSysUst, hardware systems in h wSysList, and network systems 
in nwSysList. The pathList contains all the paths in the spec files. The hostList contains all 
the hosts in the spec files; this list is also available from the entries in hwSysList. The 
processList contains a list of processes from the CONFIGURATION block. Moreover, it 
should be noted that one or more configuration blocks can exist per application. For examp le, 
an application that runs on more than one platform would havemultiple CONFIGURATION 
blocks with different platforms in each HARDWARE block. 

The application startup block contains all the information necessary to, automatically 
or manually, start an application. This information includes supported hardware (host) type, 
operating-system type, and operating-sy stem version(s). This may be further constrained by 
an optional list of the names of hosts that can run the application. The startup information 
also includes the working directory for reading and writing data files, the name of the 
executable, and an ordered list of arguments that must be passed on the command line when 
the application is started. Last is a list of processes expected to be seen on the system when 
the application is running. 

An application shutdown block indicates the command(s) to be used for terrnination 



* Dynamic Arguments 

* Shutdown Info 

•States 

• Dependencies 



•QoS Info 

• Survivability 

• Scalability 

• Hardware Specifications 

•Host Info 

• Network Info 

•LANs 

• Network Devices (Interconnects) 
• Path Specifications 

• Data Flow Graph 

• Data Flow Info 

• QoS Requirements 

It will be appreciated that a software specification is a collection of software systems, 
each of which consists of one or more software subsystems. Specification files are provided 
by the developer to capture as much knowledge about their software system as possible. 
These files provide a model of the actual systems which can be used by the Resource 
srFG42 at run-time. 
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of the applicatioa A shutdown command may be a POSIX signal name or may be a shell 
script or batch file. Supported signals include SIGKJLL. SIGQUIT, SIGHUP, SIGUSR1, 
SIGUSR2, SIGSTOP, SIGINT, and SIGTERM. The ShutdownTime parameter is the 
maximum time to wait for the an application to die gracefully before forcing the application 
to terminate via the SIGKJLL signal. 

Other blocks are available. For example, a dependency block indicates any 
dependencies the application may have with the startup and/or shutdown of other 
applications (e g., it may be required that a particular application be started before another 
application can be started). It will be noted that the dependency block is used by both 
Application Control FG50 and the Resource Manager FG42 to determine whether or not it 
is safe to start an application, stop an application, or let an application continue to run.- 

The scalability specification for an application indicates whether an application can 
be scaled via replication. Scalable applications are programmed to exploit load sharing 
among replicas, and can adapt dynamically to varying numbers of replicas. The specification 
also indicates whether an application combines its input stream (which may be received from 
different predecessor applications and/or devices), and splits its output stream (which may 
be distributed to different successor applications and/or devices) are also specified. 
"Combining" and ■splitting* are commonly called "forking" and "joining" in parallel 



Specification files advantageously can be provided to describe a given set of networks 
that exist in a distributed runtime environment. A network system specification describes the 
LANs and ICBs (interconnection devices such as switches, hubs and routers). A system 
consists of one or more subsystems. A subsystem may contain LANs (each with an 
associated peak bandwidth specification) and ICBs (each containing a description of network 
membership) 
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Advantageously, a -real-time QoS requirement specification includes timing 
constraints such as simple (leadlines, inter-processing times, and throughputs. A simple 
deadline is defined as the maximum end-to-end path latency during a cycle from the 
beginning to the end of the path. Inter-processing time is defined as a maximum allowable 

S time between processing of a particular element in the path. The throughput requirement is 
defined as the minimum number of data items that the path must process during a unit period 
of time. Each timing constraint specification may also include items that relate to the 
dynamic monitoring of the constraint. These include minimum and maximum slack values 
(that must be maintained at run- time), the size o fa moving window of measured samples that 

1 0 should be observed, and the maximum tolerable number of violations (within the window). 

CD- Appendix G described a specification grammar for declaring requirements on 
applications in a dynamic, distributed, helerogeneous Rresource pool. The grammar allows 
the description of environment -dependent application features, which allows for the 
15 modeling and dynamic Rresource management of such systems. 

A common API was developed to allow Resource Management functions -access to 
the information contained in the spec files This is an object oriented API is, in an exemplary 
case, written in C++, with libraries ported to all supported platforms. The object is populated 
20 by parsing the spec files using the BNF grammar defined by lex and yacca syntax and 
compiled with GNU tools flex and bison, as discussed above. Actual population occurs in 
the semantic actions of the yacca file. 

The SSL_System class is a generic class that can hold data for a software system, 
» hardware system, or network system. The type member describes the type of system it 
contains. It also contains a pointer to its parent (it allows for nested systems of the same 
type), and a name o f the system . The sysList contains its SS L_System children, and compList 
contains a list of the system's components (a list of hosts, for a hardware system for 
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via the RMComms TCPCommServer middleware. 

2) History Server* FGI 2A-FG1 2N that collect data from the Host Monitors, 
maintain status and performance histories on each host in the distributed 
environment via an RMComms TCPCommClienl, and provide this 

S information to displays and other Resource Management components using 
an RMComms TCPCommServer. 

3) A Host Discovery function FG14 that uses SNMP (Simple Network 
Management Protocol) calls and ping 1CMP calls to determine when new 
hosts come on-line and if existing hosts go down and providing this 

10 information to Program Control via an RMComms TCPCommServer. 

4) A Remos Network Data Broker FG 1 6 that collects information on network 
link bandwidlhs from Carnegie Mellon University's SNMP-based Remos tool 
and passes this information by way of an RMComms TCPCommServer to the 
Host Load Analyzer component of the -Resource Allocation Decision- 

IS Making subsystem. 

It will be appreciated that Network information is collected by both the Remos broker 
FG16 and indirectly via the Host Monitors FG10A-FG10N. See FrgFIGS. 22A. 2B. The 
Remos Broker FGI 6 accesses the Remos network information via the Remos API. -As 

io mentioned previously, Remos uses SNMP calls to the LAN switches and hosts. -The Host 
Discovery function FG14 uses both- SNMP and ICMP (ping) calls to each host A-N to 
determine if anew host(s) has (have) come on-line or previously discovered hosts have gone 
down. The Host Monitors FG 1 OA-FG 1 ON employ Operating System calls to gather host and 
network performance statistics. -Internally, the History Servers FG12A-FG 1 2N collect data 

25 from the Host Monitors FG10A-FG210N- The Monitoring functional group provides its 
information to the rest of the Resource Management components using RMComms 
TCPCommServer objects, which are discussed in detail elsewhere.* The Remos Broker FG 1 6 
sends data to the Host Load Analyzer FG40, the History Servers FG12A-FG12N send data 
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example). 

Preferably, the Application Program Interface (API) for the System Specification 
J Library (SSL) FG34 uses the C++ Standard Template Library for data structures such as 
linked lists and hash tables (maps). An application first instantiates the SSL object by calling 
its constructor with the name of the directory where the specification files reside. This object 
contains functions that allow setting this directory after calling its constructor 
(setS pecDir(directory name)), clearing the object of all currently held data (clear()), parsing 
10 a specific file (parseSpec< filename)), and rebuilding the object (rebuild!), implicitly clears 
the object first). Once instantiated, this object provides access to the data in the specification 
files. -CD-Appendix G provides additional discussion regarding this aspect of the SSL - It 
will be appreciated that the SSL object provides methods that return all the data it contains 
For example, the getSWSystems returns an STL list of all the software systems specified in 
1J the specification files. Each entry in this list provides its data by methods such as 
getSysNameO, and the set of application components (ApplicationSpec) that make up the 
system. All data can be retrieved in this manner. 

FC1: HOST AND NETWORK MONITORING FUNCTIONAL GROUP 

10 

As mentioned above, extensive monitoring capabilities are provided in the Resource 
Management architecture at the host and network levels. -The information monitored 
includes statuses, configuration information, performance metrics, and detected fault 
conditions - Moreover, the Host and Network functional group FGI consists of four 
25 components including: 

1) Host Monlton FG10A-FG10N, that reside on each machine in the 
distributed environment and collect extensive operating system-level data for 
each host (CPU and memory' usage, etc) and provides it to the History Servers 
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to the Display functional group FG6 and Host Load Analyzer FG40, and the Host Discovery 
function FGI 4 provides Program Control FG50 with information on detected or faulted 
hosts Additional details on these functional elements are provided immediately below. 

5 FC10A-FG 1 ON Host Monitors 

For monitoring the status and performance of hosts, a Host Monitor process runs on 
each machine within the distributed environment. -These Host Monitors FGIOA^-FGION 
use operating system-level mechanisms to retrieve status, configuration, and performance 

10 information of each host A-N - The information retrieved includes 1) operating system 
version arid machine configuration, 2) CPU configuration, status, and utilization, 3) memory 
configuration and usage, 4) network configuration, status, and utilization, 5) filesystem 
configuration, status, and utilization, and 6) process statuses including CPU, memory, 
network, and filesystem utilization foreach process. -While the Host Monitors are primarily 

i s responsible for monitoring the status of a particular host they also provide information on 
network load as seen by a particular host. In the same manner, the Host Monitors FG 1 0A-- 
FG ION also provide information and statistics concerning any remotely mounted filesystems 
(e.g.NFS).- 

20 Preferably, the information the Host Monitors FGI OA^- FGI ON collect is formatted 
into operating system-independent message formats.- These message formats attempt to 
provide a pseudo-standard ized set of stale, status, and performance information which is 

components do not hav e to be aware of or deal with the minor deltas between data formats 
25 and semantics.- Since not all the state and performance data is available on every platform, 
to indicate which information is av ailable, a group of flags are set in the host configuration 
message indicating whether specific data items are valid on a particular platform. 
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It will be appreciated that the Host Monitors FGIOA^-FGION have a very specific 



* with the History Servers FG12A2-FG12N- It periodically (once a second) sends 
its data to all History Serv ers connected to it (this is transparent, a property of the RMComms 
TCPCommServer); -the History Server makes no requests to the Host Monitors.- 

More specifically, the Host Monitors FGIOA-FG10N have been designed and 
implemented in C++. This decision allows for a completely modular design in which 
platform-specific code can be restricted to a small number of modules. This approach 
alleviates any of the problems associated with porting to various platforms. Currently there 
is support for Sun SPARC based architectures running Solaris 2.6 and 2. 7, Silicon Graphics 
MIPS based architectures running IRIDrX 6.5., Hewlett Packard PAHRisePA-RISC based 
architectures running HP 1020, and Pentium based architecture running both WinNT 4.0 
Workstation and Red Hat Linux 6.0. The Host Monitor source compiles under the native 
compilers provided by Sun Microsystems and Silicon Graphics for their respective platforms. 
The Gnu C++ compiler (version 2. 8. 1 ) may also be used on Hewlett Packard PA-ftisePA- 
RISC based architectures under HP-UX 10.20 and Red Hat Linux - Microsoft Visual C++ 
compiles the Windows NT Host Monitor.- All Host Monitors utilize the I/O library package 
supported by the Resource Management (RM) group under the NSWCYHigh Performance 
Distributed Computing (Hi per D) initiative. 

The Host Monitors FG10A-FG10N accumulate data on a periodic interval specified 
at invocation. System process table data is accumulated and then filtered to eliminate 
"uninteresting" processes- (usually meaning processes belonging to user ID 0 or I). It is 
important to note that system-wide data is accumulated and processed before the filtering 
stage, so as to insure a complete picture of system- wide performance. This system- wide data, 
along with the filtered process list, is then made av ailable to the I/O module for subsequent 
transmission to client applications. 
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The History Server function of Resource Management acts as a data broker between 
daemons monitoring individual hosts, known as host monitors FGI0A-FG10N, and other 
functional components of Resource Management. -The host monitors collect performance 
information (such as CPU utilization and process status data) from hosts of various platforms 
(SGI, SUN, HP, Windows NT, and Linux). -The host monitors use a RMComms 
TCPCommServer object to distribute this data. -For further information, refer to the host 
monitor and RMComms documentation.- The History Servers FG12A-FG12N collect and 
store this data from the host monitors FGIOA-FG10N and distribute it to other Resource 
Management Clients, such as the Host Displays FG62A-FG62N, Graph Display FG69A- 
FG69N, Path Display FG64, and the Hardware Broker. FG40 

Each History Server has two modes of operation relating to fault tolerance, 
scalability, and workload distribution between multiple instances of History Servers.- The 
first mode determines at initialization (through command line arguments or default) the set 
of hosts to monitor, and this set remains static for the life of the History Server process. -The 
second mode recognizes the existence of other History Serv er processes and coordinates 
between them.- It allows for dynamic changing of the set of hosts each History Server 
monitors (example: two History Serv ers each monitoring half of the hosts, a third History 
Server starts, and all three History Servers reconfigure to each monitor one third of the 
hosts.)- This also allows History Serv ers to preserve the data it collected by sending it to the 
others, providing fault tolerance. 

The History Server function is written in C++ with an object-oriented design. -The 
main routine processes the command line arguments, retriev es the list of hosts to monitor 
using an SSL object, instantiates the main History _Server object, and spawns the Collector. 
Distributor, Communicator, and Display thread. —These threads share the main 
History_Server object- The Collector thread is responsible for collecting and storing data 
from the host monitors. The Distributor thread processes requests from RM Clients - The 



FC12A-FG12N: History Servers 

The History Ser\ ers FG 1 2 A--FG 1 2N are responsible for collecting informati on from 
the Host Monitors end maintaining histories on the statuses, statistics, and performance of 
each host in the distributed environment. -This information can be requested by other 
Resource Management functional group - Currently, the primary consumers of the status 
information are the Host Load Analyzer (Hardware Broker) FG40 component of the 
Resource Allocation Decision-Making functional group FG4, the Host Displays) FG62A- 
FG62N, and the Path Display FG64. -The Host Load Analyzer FG40 receives information 
on host configuration and loads (primarily CPU, -memory, and network data) and uses this 
to assign host fitness scores - The Host Displays FG62A-FG62N receive and display current 
host status information, process status information, and network connectivity information. 
It should be mentioned that the Host Display can also request that the History Servers 
provide CPU load information, network load information, paging activity data, and memory 
utilization information which is used to drive line graph charts for specific hosts selected at 
the Host Display. 

The History Servers FG 1 2A-FG 1 2N are designed so that multiple copies can be run 
simultaneously. -Each History Server can be configured to either monitor all Host Monitors 
FG10A-FG10N or to monitor only' a selected subset of the Host Monitors. -It will be noted 
that the History Sen ers FG 1 2A - FG 1 2Nu e t e i minc FGl 2 A-FC 1 2N determine the list ofhosts 
in the distributed environment that could potentially be monitored from the System 
Specification Library (SSL).- In this manner, the History Servers FG12A-FGI2N can be 
used to provide surv ivability (by having multiple History Servers FG 1 2A-FG1 2N connected 
to each Host Monitor) and/or to perform load-sharing (with the History Servers FG1 2A- 
FG 1 2N each monitoring only a subset of the Host Monitors) The History Servers FG 1 2A- 
FG1 2N can also be configured to periodically record history data to disk.- These disk files 
can then be used for off-line analysis 
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Communicator thread w*its for events with other History Servers and takes appropriate 
actions, including triggering the Display thread to update the History Server Display. 

FGM-Hoit Discovery 

The Host Discovery function FG14 advantageously can use a Perl script that makes 
SNMP (Simple Network Management Protocol) calls and ICMP ping calls. These calls are 
used to periodically scan each subnet and host address in the distributed environment to 
attempt to determine whether there have been any host status changes. ■ In an exemplary case, 
the list ofhosts and subnets that are to be monitored is read in from a file.- 

The host discovery FG 1 4 issues MIB-fl SNMP queries to obtain information on the 
hosts A-N on the network. -When a new host is first detected, the new host's operating 
system configuration is queried via SNMP calls, information on the newly discovered host 
and its operating system configuration is then sent to the Program Control function FG50. 
Likewise, when a host fails to respond to multiple SNMP and ping queries, a message 
indicating that the host appears to have gone down is sent to the Program Control function. 

The Host Discovery function FG14 -interfaces with Program Control FG50 using a 
C++ wrapper class around the Perl script - This wrapper class contains an RMComms 
TCPCommServ er, making the data collected by the SNMP calls available to the rest of the 
Resource Management components. 

PG16 - Remoi Network Data Broker 

The final functional component of the Host and Network Monitoring functional 
group is the Remos Network Data Broker FG 16 which receives information on network link 
bandwidth and network link bandwidth utilization from the SNMP-based Remos network 
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monitoring tool, as shown in FigFIGS. 22 A, 2B and/or FtglG. H4I4- The network 
information is accessed via the Rem OS API library and is then sent on to the Host Load 
Analyzer (Hardware Broker) function FG40 of the Resource Allocation Decision-Making 
functional grotrpfOtgmup FG4 using an RMComms TCPComrnServer.- Remos works by 
5 using SNMP to query the switches (via the bridge collector) to collect information on 
network configuration as well as bandwidth utilization on each link and also issues SNMP 
MIB-II queries to each host to collect the host's view of network utilization.- The network 
information received from Remos consists of the maximum potential bandwidth and the 
current bandwidth utilization on specific host network links. 

10 

The Remos Broker FGl 6 provides the following information about the network link 
for each host. The data is sent to the Host Load Analyzer (Hardware Broker) approximately 
every 2 seconds. The Remos Broker FG 1 6 uses configuration files listing specific hosts and 
switches that should be queried. 

li 

The functions implemented by Host Monitor functional group FGl have been 
designed to provide a system monitoring capability not normally supplied by standard SVR4 
or BSD Unix serv ices. Such services include cross-platform reporting of system process 
loading-, CPU performance, network performance and periodic status summary reporting. 
20 The Host Monitors were developed to support efforts by the Hiper-D Resource Management 
group, attempting to provide a common set of OS level parameters useful for assessing host 
and network load and status, for supporting ((resource allocation/reallocation algorithms, and 
attempting to provide a minimally intrusive, close to real-time capability for gathering this 

25 

Host Discovery Design 

The Host Discovery function FGl 4 of the Resource Management architecture 
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network device (in this case, the configuration of each reachable host). 

The host discovery pi script makes SNMP calls by using subroutines freely available 
for public use (freeware), created by Simon Leinen, -These subroutines are contained in the 
5 files BER.pm and SNMP_Session.pm - The SNMPjSession is configurable for specifying 
timeouts and number of retries before declaring a host unavailable, and for specifying the 
SNMP Object UM01D). 

Additional general and specific details regarding functional elements of the Host and 
to Networking functional group FGl are provided in CD-Appendix H. 

FG2: InstrumeRtstion functional group 

As mentioned above, the NSWC-DD Instrumentation Svstem provides general - 
1 5 purpose application event reporting and event correlation capabilities. The Instrumentation 
system forms an architecture that allows instrumented application data to be easily accessible 

components of the Instrumentation System architecture are the following: 

1) The Instrumentation API Libraries, which are linked with the applications 
20 and provide the function call interfaces by which the application sends 

instrumentation data. 

2 ) An Instrumentation Daemon, one copyo f which resides on each host in the 

sent by the applications, reformatting the data into instrumentation event 
is messages and sending the messages to the Instrumentation Collectors. 

3) The Instrumentation Collectors, which connect to the Instrumentation 
Daemons on each host and receive instrumentation messages from all hosts. 
The Collectors forward received messages to the Instrumentation Correlators 
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provides ^resource discovery of hosts on a network - It identifies new- hosts that come online 
or previously known hosts that have gone offline - The Host Discovery component can 
determine the hostname, the operating system name and version, and in some cases the 
machine architecture and manufacturer of a newly discovered host- This information is sent 
5 to Program Control so the new host can be added to the pool of resources 

The Host Discovery functional element FGl 4 consists of a Perl script that contains 
the Rresource discovery functionality, and a C++ object that receives the output of the Perl 
script and provides this information to Program Control via an RMComms TCPComrnServer 

10 connection. -This is described in CD-Appendix H- More specifically, the Perl script 
hosi_discovery.pl issues ICMP (ping) calls and MIB-II SNMP queries to discover new hosts. 
On initialization, the script populates a data structure called Netjnfo for each of the 
networks (subnets) it needs to monitor. - Currently this information is hard-coded, the subnet 
is defined as 1 72.30. 1 , and the lower and upper limits for the host are 1 and 254 respectively. 

1 5 It then initializes the global v ariables for the server host and port, network domain, and the 
executable path for the ping (fpirtg) command 

The host_discovery.pl script establishes a baseline of existing hosts using the current 
set of hosts that answer the fptng call, For each network/subnet defined in its list of Netjnfo 

io (Netjnfo.pm) data structures, it calls fping and builds a list of IP addresses of hosts that 
answered the ping, known as reachable hosts, and a list for those hosts that did not answer 
the ping -For each reachable host, a Host info (Host_info.pm) data structure is populated 
to store the host's information.- (Key fields in the Host info data structure include IP address, 
hostname, operating system and version, architecture class, and manufacturer.) -Since the IP 

25 address of the reachable host is known, a call to gethostbyaddrO is used to get the hostname. 

Other information for the host is obtained by making a MIB-II (Management Interface Base 
version 2)system Group (Object ID 1,3.6.1.2.1.1.1.0) SNMP call to the SNMP agent on each 
reachable host- This SNMP query returns information on the configuration of a specific 
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and Instrumentation Brokers. 

4) The Instrumentation Correlators, which receive instrumentation messages 
from the Instrumentation Collectors and prov ide grammar-driven capabilities 

S metrics (composite events) for use by displays or other Resource 
Management components. 

5) The Instrumentation Broken, which receive instrumentation messages 
from the Instrumentation Collectors and perform task-specific reformatting 
and data manipulation for driving display? or other Resource Management 

10 components. 

(t» 6) Tr»JefwdlnitnuiMnutionBroker(OoS Monitor), which 

is a legacy component that can receiv e instrumentation data 
from either the open source Jewel instrumentation package or 
' from the Insrrumeritalion Collectors. The QoS Monitor 
15 performs task-specific message reformatting and data 
manipulation for driving displays and the QoS Managers 

Instrumentation API Library 

20 

The applications link in the Instrumentation API Library' and make API call to 
construct and send out instrumentation ev ent messages. Three separate APIs are provided for 
use by the applications: 1 ) a printfl.)-style API which allows the code to format, build, and 
send instrumentation data with a single function call, 2) a buiTer-coristruction-srvIe API 
23 where the multiple function calls are made to construct the instrumentation buffer iterati very, 
one data element per call, and 3) a Jewel function call API based on the existing API 
provided by the Jewel instrumentation package (an open-source package produced by the 
German National Research Center for Computer Science). The first two APIs are the 
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preferred programming interfaces and take advantage of several key new instrumentation 
features. It will be appreciated that the Jewel API is provided solely for backwards 
compatibility with existing instrumented application code and is implemented as a set of 
wrappers around the prtntfl>style API. All three APIs are supported for C and C++. Ada 
bindings have been produced for the buffer-construction-style API and the Jewel function 
call API. 

The instrumented data is sent from the application to the Instrumentation Daemon on 
the same host. The current mechanism for data transfer is via UNIX FIFO IPC (inter-process 
communication) mechanisms. The FIFO mechanism was chosen based on reliability, low 
overhead, and ease of implementation. Future implementations of the Instrumentation system 
may explore alternate data passing mechanisms including shared message queues. 



An Instrumentation Daemon resides on each host in the distributed environment. The 
Instrumentation Daemon is interrupted when new data is written to the FIFO. The 
Instrumentation Daemon reads the data from the FIFO and reformats the data into the 
standard internal Instrumentation message format and sends the data to each of the 
Instrumentation Collectors that are currently active. (For future implementations, an event 
request filtering mechanism will be implemented so that specific event messages will only 
be sent to those Instrumentation Collectors that have requested the message.) 

Instrumentation Collector) 

The Instrumentation Collectors receive instrumentation messages from the 
Instrumentation Daemons on each host in the distributed environment. Currently, the 
Instrumentation Collectors send every instrumentation message to all Instrumentation 
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The Jew el Instrumentation Broker (hereafter referred to the QoS Monitor) is a legacy 
architecture component that served as a broker between the Jew el instrumentation package 
components and Resource Management components and displays. The QoS Monitor was 
responsible for polling the Jewel Collector components to retrieve application event 
messages. These messages were then reformatted and used to drive several displays and the 
QoS Managers. The Jewel instrumentation package has now been replaced in all 
applications, however the message reformatting capabilities of the QoS Monitor have been 
maintained so that several displays and the existing QoS Manager interface do not have to 
be upgraded immediately. The QoS Monitor component has been modified so that it receives 
instrumentation data from both Jewel and the Instrumentation Collectors. 



The RMComms middleware package, which is described in the RMComms 
Middlew are Design Report, provides the internal message passing interfaces betw een the 
Resource Management components connected via the network. The middleware provides for 
automatic location-transparent many-to-many client-server connections. Low overhead, 
reliable message passing capabilities are provided. Registration of message handler callback 
functions for specified requested message types are provided with the message handler 
functions being invoked when messages arrive. Registration of connection status callback 
functions which are invoked when either new connections are made or existing connections 
are broken is also provided. The middleware package also allows for multiple client and 
server objects to be instantiated in the same application, is thread-safe, and provides an easy- 
to-use object-oriented API through which all capabilities are accessed. 

Additional details regarding the Instrumentation functional group FG2 are provided 
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Brokers and Instrumentation Correlators that have connected to the Instrumentation 
Collector. (For future implementations, an event request filtering mechanism will be 
implemented so that specific event messages will only be sent to those Instrumentation 
Brokers and Instrumentation Correlators that have requested the message. For now, the 
Instrumentation Collector serves as a pass-through server for instrumentation messages . The 
Instrumentation Collector does supports architecture scalability in the sense that without the 
Instrumentation Collectors, each Instrumentation Broker and Instrumentation Correlators 
would need to maintain connections to the Instrumentation Daemons on every host.) 

Instrumentation Correlator* 

The Instrumentation Correlators pro vide gram mar -dri ven capabili lies for correlating, 
combining, and reformatting application data into higher-level metrics {composite events) 
for use by displays or other Resource Management components. Each Correlator reads in a 
user-specified correlation grammar file that is interpreted at run-time by the Correlator's 
instrumentation correlation engine. 



The Instrumentation Brokers are task-specific applications built around a common 
code package. The Instrumentation Broken receive instrumentation messages from the 
Instrumentation Collectors, filter all received instrumentation messages to find the messages 
of interest, and perform task-specific message data reformatting and manipulation for driving 
other components such as displays or other Resource Management components. The 
Instrumentation Broker approach allow* for instrumentation data sources to be quickly 
integrated for test, display, and debugging purposes. (As the Instrumentation Correlator 
grammar and correlation engine mature in future releases, it is anticipated that the 
Instrumentation Broker approach will be used less frequently, ) 
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FG42: Resource Manager 

The Resource Manager 42 is the primary decision-making component of the 
Resource Management toolkit. It is responsible for 1) responding to application and host 
failures by determining if and what recovery actions should be taken, 2) deterrnining if and 
where to place new copies of scalable applications or which scalable applications should be 
shutdown when (he QoS Managers FG44A-FG44N indicate that scale-up or scale-down 
actions should be taken based on measured application performance, 3) deterrnining where 
new applications should be placed when requested to do so by Program Control, and 4) 
determining which and bow many applications should run based on application system 
(mission) priorities. In order to accomplish these tasks, the Resource Manager 42 maintains 
a global view of the state of the entire distributed environment including status information 
on all hosts, networks, and applications. En addition, the Resource Manager 4 2 also cal culates 
software and hardware readiness metrics and reports these readiness values for display 
purposes. Fig ur e i FIGS. I A, IB shows the connectivity and high-level data flow between 
the Resource Manager 42 and the other Resource Management- related components. 

The Resource Manager 42 receives status and failure information about hosts, 
networks, and applications from Program Control. This information includes periodic status 
updates as well as immediate updates when statuses change such as a new host being 
detected or an application failing. In the case of applications going down, information as to 
whether the applications were shutdown on purpose or whether they failed is also sent. 
Program Control also issues requests to the Resource Manager 42 when new applications 
need to be dynamically allocated and when Program Control determines thai the Resource 
Manager 42 needs to assess and attempt to resolve inter-application dependencies (such as 
an application which needs to be running prior to starting up another application). 
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The Resource Manager 42 responds to faulted applications and hosts by determining 
whether the failed applications can and should be restarted and attempting to determine 
where (and if) there are hosts available that the application can run on. When a decision is 
made by the Resource Manager 42, a message is sent to Program Control specifying what 
application to start and where to put it. The same general mechanism is used when Program 
Control requests that the Resource Manager 42 determine where to start new applications 
and/or how to resolve inter-application dependencies; the Resource Manager 42 responds 
with orders indicating what applications to start and where to start them. The Resource 
Manager 42 also sends application shutdown orders to Program Control requesting that 
certain application be stopped; this can occur when the QoS Managers FG44A-FG44N 
indicate that certain scalable applications have too many copies running or when application 
system priority changes (to lower priorities) occur resulting in scaling back the application 
system configuration. 

The Resource Manager 42 receives host load and host fitness information on all 
known hosts from the Hardware Broker 40 (Host Load Analyzer) This information include 
overall host fitness scores, ep u - bas edC PU-based fitness scores, network-based fitness scores, 
and memory and paging-based fitness scores along with the SPEC95 ratings of the hosts. 
This information is received approximately once a second and includes information on all 
known hosts in the distributed system These scores are used by the Resource Manager 42 
fordeterrnining the "best" hosts for placing new applications when: 1 ) responding to requests 
from the QoS Managers FG44A-FG44N to scale up additional copies of an application, 2) 
attempting to restart failed applications, 3) responding to requests to dynamically allocate 
certain applications, and 4) responding to application system (mission) priority changes 
which require scaling up additional applications. 

The Resource Manager 42 receives requests from iheQoS Managers FG44A-FG44N 
for scaling up, moving, or scaling down specific applications. The Resource Manager FG42 
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Specification Files for specified applications. The information is used by the Resource 
Manager FG42 to determine whether the specific applications will be restarted if they fail at 
run-time. 

The Resource Manager FG42 sends application system and hardware system 
readiness and system (mission) priority information to the Readiness Broker and to the 
Globus Broker. The Readiness Broker is responsible for driving a GUI/display which shows 
the current readiness data and allows the system (mission) priorities to be changed and sent 
back to the Resource Manager FG42. The Globus Broker provides basically the same 
functionality except that only a high-level subset of the readiness data provided to the 
Readiness Broker is provided to the Globus Broker. The readiness information sent to the 
Readiness Broker consists of readiness values for each application, application subsystem, 
and application system defined in the System Specification Files. The readiness scores are 
currently based on the status (up/down) of the applications within a system or subsystem 
along with the percentage of potential copies of scalable applications that are currently 
running Host and network readiness scores are also calculated and are the scores are 
determined based on the host load information and host fitness scores received from the 
Hardware Broker 40. 

The Resource Manager FG42 also sends information about allocation and 
reallocation decisions to the Resource Management Decision Review Display. Information 
on the decision that was made, what event the decision was in response to, and how long it 
took to both make the decision and implement the decision are sent to the display. In 
addition, information about the top choices for where an application could have potentially 
been placed is also sent (if applicable); this information includes the host fitness scores for 
the selected host and the next best host choices which could have been selected. 

See CD- Appendix M for additional details regarding Resource Manager FG42. 



responds to these requests by determining whether the request should be acted upon and, if 
so, determines the specific action to take and issues orders to Program Control to start up or 
shutdown specific applications on specific hosts. The QoS Managers FG44A-FG44N are 
responsible for monitoring specific system performance metrics (e.g., quality of service, or 
QoS, requirements) via instrumentation and determining if performance can be unproved by 
scaling up or moving certain applications. When this occurs, the QoS Managers FG44A- 
FG44N send a request to the Resource Manager FG42 indicating that a new copy of a 
specific application should be started. If the QoS Managers FG44A-FG44N determine that 
the performance of a scalable ap plicati on can be improved by mo ting an application, a scale 
up request is first sent to the Resource Manager FG42 and when the new application has 
been started, a scaledown request is then sent to the Resource Manager. Also, when the QoS 
Managers FG44A-FG44N determine that there are more copies of scalable application 
running then are needed, requests to shutdown specific applications are sent to the Resource 
Manager FG42. The division of responsibility is that the QoS Managers FG44A-FG44N 
determine what actions would potentially improve performance, but the Resource Manager 
FG42 has final authority to determine whether to implement the requested actions. 

When the Resource Manager FG42 is first started, it reads in the System 
Specification Files (via System Specification Library, SSL, calls) which contain the list of 
hosts that are known to be in the distributed environment and information on all applications 
thai can be run in the distributed environment. The System Specification Files also include 
application-level information including where specific applications can be run, which 
applications are scalable, which applications can be restarted, and any dependencies between 
applications. 

The Resource Manager FG42 can also receive updated application survivability 
specifications from the QoS Specification Control component. This information overrides 
the application survivability information that was initially loaded in from the System 
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In the Background Section of the application, the reader may have interpreted the 
sentence The present invention relates generally to resource management systems by which 
netw orked computers cooperate in performing at least one task too complex for a single 
computer to perform" to indicate that the Resource Management Architecture is limited to 
such applications.- Thus, while the Resource Management Architecture generally supports 
tasks distributed across multiple hosts, ii is not limited to only those tasks that must be 
distributed due to the inability to run them on a single machine - Moreover, the Resource 
Management functional elements advantageously could be used to control a set of 
applications which all run on the same machine while still providing monitoring, fault 
tolerance, etc. (albeit that this is not the normal or even the intended configuration). 
Furthermore, the Resource Management Architecture, as discussed above, d«Js with 
resource managed applicauons. where the managed characteristic may be one of scalability, 
survivability, fault tolerance or priority. 

FrglG. 15 is a block diagram of a CPU-based system 400, corresponding to one or 
more of the hosts A-N.- The system 400 includes a central processing unit (CPU) 402, e.g., 
a microprocessor, that communicates with the RAM 4 1 2 and an I/O device 408 over a bus 
420. It must be noted that the bus 420 may be a series of buses and bridges commonly used 
in a processor-based system, but for convenience purposes only, the bus 420 has been 
illustrated as a single bus. A second I/O device 410 is provided in an exemplary case. The 
processor-based system 400 also includes a primary memory 4 1 2, an additional memory 4 1 4, 
which could be either a read-only memory (ROM) or another memory device, e.g., a hard 
drive or the like. The CPU- based system may include peripheral devices such as a floppy 
disk drive 404, a compact disk (CD) ROM drive 406. a display (not shown), a key board (not 
shown), and a mouse (also not shown), that communicate with the CPU 402 over -the bus 
420 as is wtJI known in the art. It will be appreciated that the diner one of the memories 412 
or 414 advantageously can be employed to store computer readable instructions for 
convening the general purpose system 400 into one of the host A-N. -It will also be 
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appreciated that the nature of the distributed environment permits the necessary application 
and API's needed to implement the Resource Management Architecture to9 be stored 
anywhere on the network 
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provided on the CD-ROM filed concurrently -with the application. In addition, the CD-ROM 
also includes the source code listing for the Resource Management Architecture according 
to the present invention. 

Although presently preferred embodiments of the present invention have been 
described in detail herein, il should be clearly understood that many variations and/or 
modifications of the basic inventive concepts herein taught, which may appear to those 
skilled in the pertinent an, will still fall within the spirit and scope of the present invention, 
as defined in the appended claims. 
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APPENDIX 


TYPE 


DESCRIPTION 


A 


Attached 




B 


Attached 


Standard Instrumentation Message Format 


C 




API Listing for RMCamnu 


□ 


CD 


Resource Manager Interface Message* 


E 


CD 


Host Load Analyzer (Hardware Broker) Function 


F 


CD 


Quality -of-»crvice (QoS) Manager Function 


G 


CD 


FjQ3:- System Specification Language & System Specification 
Library (SSL) Functions 


H 


CD 


Host And Network Monitoring Functional Group 


I 


CD 




J 


CD 


Display Functional Group 


K 


CD 


RrncMCoroms Network Communication Middleware Design 


L 


CD 


System Readiness Display 


M 


CD 


Resource Manager Rm42FG42 


N 


CD 




O 


CD 


Host Discovery Function 


P 


CD 


Instrumentation Application Programming Interface (API) 


Q 


CD 


Program Control Application Controller 


R 


CD 


Program Control Display 


S 


CD 


Program Control Functional Group 


T 


CD 


QoS Manager 


U 


CD 


Resource Allocation Decision-making Functional Group 
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Table 111 provides a listing of the Appendices included for all purposes in the 
application- It will be noted that the majority of the listed Apertaiere s Appendices are 
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